TAKT
Task Agent Koordination Tool - Claude Code向けのマルチエージェントオーケストレーションシステム（Codex対応予定）
Note
: このプロジェクトは個人のペースで開発されています。詳細は免責事項をご覧ください。
必要条件
- Claude Code がインストール・設定済みであること
インストール
npm install -g takt
クイックスタート
# タスクを実行（ワークフロー選択プロンプトが表示されます）
takt "ログイン機能を追加して"
# ワークフローを切り替え
takt /switch
# 保留中のタスクをすべて実行
takt /run-tasks
コマンド一覧
| コマンド | 説明 |
|---|---|
takt "タスク" |
ワークフロー選択後にタスクを実行 |
takt -r "タスク" |
前回のセッションを再開してタスクを実行 |
takt /run-tasks |
保留中のタスクをすべて実行 |
takt /switch |
ワークフローを対話的に切り替え |
takt /clear |
エージェントの会話セッションをクリア |
takt /help |
ヘルプを表示 |
実践的な使い方ガイド
-r でセッションを再開する
TAKTの実行中にエージェントから追加の情報を求められた場合（例：「詳細を教えてください」）、-rフラグを使って会話を継続できます：
# 最初の実行 - エージェントが確認を求めることがある
takt "ログインのバグを直して"
# 同じセッションを再開して要求された情報を提供
takt -r "パスワードに特殊文字が含まれているとバグが発生します"
-rフラグはエージェントの会話履歴を保持し、自然なやり取りを可能にします。
MAGIシステムで遊ぶ
MAGIはエヴァンゲリオンにインスパイアされた審議システムです。3つのAIペルソナがあなたの質問を異なる視点から分析し、投票します：
# プロンプトが表示されたら'magi'ワークフローを選択
takt "RESTからGraphQLに移行すべきか？"
3つのMAGIペルソナ：
- MELCHIOR-1（科学者）：論理的、データ駆動の分析
- BALTHASAR-2（母性）：チームと人間中心の視点
- CASPER-3（現実主義者）：実用的で現実的な考慮
各ペルソナは APPROVE、REJECT、または CONDITIONAL で投票します。最終決定は多数決で行われます。
/run-tasks でバッチ処理
/run-tasksコマンドは.takt/tasks/ディレクトリ内のすべてのタスクファイルを実行します：
# 思いつくままにタスクファイルを作成
echo "認証モジュールのユニットテストを追加" > .takt/tasks/001-add-tests.md
echo "データベースレイヤーをリファクタリング" > .takt/tasks/002-refactor-db.md
echo "APIドキュメントを更新" > .takt/tasks/003-update-docs.md
# すべての保留タスクを実行
takt /run-tasks
動作の仕組み：
- タスクはアルファベット順に実行されます（
001-、002-のようなプレフィックスで順序を制御） - 各タスクファイルには実行すべき内容の説明を含めます
- 完了したタスクは実行レポートとともに
.takt/completed/に移動されます - 実行中に追加された新しいタスクも動的に取得されます
タスクファイルの形式：
# .takt/tasks/add-login-feature.md
アプリケーションにログイン機能を追加する。
要件：
- ユーザー名とパスワードフィールド
- フォームバリデーション
- 失敗時のエラーハンドリング
これは以下のような場合に最適です：
- アイデアをファイルとしてキャプチャするブレインストーミングセッション
- 大きな機能を小さなタスクに分割する場合
- タスクファイルを生成する自動化パイプライン
カスタムワークフローの追加
~/.takt/workflows/にYAMLファイルを追加して独自のワークフローを作成できます：
# ~/.takt/workflows/my-workflow.yaml
name: my-workflow
description: カスタムワークフロー
max_iterations: 5
steps:
- name: analyze
agent: ~/.takt/agents/my-agents/analyzer.md
instruction_template: |
このリクエストを分析してください: {task}
transitions:
- condition: done
next_step: implement
- name: implement
agent: ~/.takt/agents/default/coder.md
instruction_template: |
分析に基づいて実装してください: {previous_response}
pass_previous_response: true
transitions:
- condition: done
next_step: COMPLETE
エージェントをパスで指定する
ワークフロー定義ではファイルパスを使ってエージェントを指定します：
# ビルトインエージェントを使用
agent: ~/.takt/agents/default/coder.md
agent: ~/.takt/agents/magi/melchior.md
# プロジェクトローカルのエージェントを使用
agent: ./.takt/agents/my-reviewer.md
# 絶対パスを使用
agent: /path/to/custom/agent.md
カスタムエージェントプロンプトをMarkdownファイルとして作成：
# ~/.takt/agents/my-agents/reviewer.md
あなたはセキュリティに特化したコードレビュアーです。
## 役割
- セキュリティ脆弱性をチェック
- 入力バリデーションを検証
- 認証ロジックをレビュー
## 出力形式
- [REVIEWER:APPROVE] コードが安全な場合
- [REVIEWER:REJECT] 問題が見つかった場合（問題点をリストアップ）
ワークフロー変数
instruction_templateで使用可能な変数：
| 変数 | 説明 |
|---|---|
{task} |
元のユーザーリクエスト |
{iteration} |
現在のイテレーション番号 |
{max_iterations} |
最大イテレーション数 |
{previous_response} |
前のステップの出力（pass_previous_response: trueが必要） |
{user_inputs} |
ワークフロー中の追加ユーザー入力 |
{git_diff} |
現在のgit diff（コミットされていない変更） |
ワークフロー
TAKTはYAMLベースのワークフロー定義を使用します。以下に配置してください：
~/.takt/workflows/*.yaml
ワークフローの例
name: default
max_iterations: 10
steps:
- name: implement
agent: coder
instruction_template: |
{task}
transitions:
- condition: done
next_step: review
- condition: blocked
next_step: ABORT
- name: review
agent: architect
transitions:
- condition: approved
next_step: COMPLETE
- condition: rejected
next_step: implement
ビルトインエージェント
- coder - 機能を実装しバグを修正
- architect - コードをレビューしフィードバックを提供
- supervisor - 最終検証と承認
カスタムエージェント
.takt/agents.yamlでカスタムエージェントを定義：
agents:
- name: my-reviewer
prompt_file: .takt/prompts/reviewer.md
allowed_tools: [Read, Glob, Grep]
status_patterns:
approved: "\\[APPROVE\\]"
rejected: "\\[REJECT\\]"
プロジェクト構造
~/.takt/
├── config.yaml # グローバル設定
├── workflows/ # ワークフロー定義
└── agents/ # エージェントプロンプトファイル
API使用例
import { WorkflowEngine, loadWorkflow } from 'takt'; // npm install takt
const config = loadWorkflow('default');
if (!config) {
throw new Error('Workflow not found');
}
const engine = new WorkflowEngine(config, process.cwd(), 'My task');
engine.on('step:complete', (step, response) => {
console.log(`${step.name}: ${response.status}`);
});
await engine.run();
免責事項
このプロジェクトは個人プロジェクトであり、私自身のペースで開発されています。
- レスポンス時間: イシューにすぐに対応できない場合があります
- 開発スタイル: このプロジェクトは主に「バイブコーディング」（AI支援開発）で開発されています - 自己責任でお使いください
- プルリクエスト:
- 小さく焦点を絞ったPR（バグ修正、タイポ、ドキュメント）は歓迎します
- 大きなPR、特にAI生成の一括変更はレビューが困難です
詳細はCONTRIBUTING.mdをご覧ください。
Docker サポート
他の環境でのテスト用にDocker環境が提供されています：
# Dockerイメージをビルド
docker compose build
# コンテナでテストを実行
docker compose run --rm test
# コンテナでlintを実行
docker compose run --rm lint
# ビルドのみ（テストをスキップ）
docker compose run --rm build
これにより、クリーンなNode.js 20環境でプロジェクトが正しく動作することが保証されます。
ドキュメント
- Workflow Guide - ワークフローの作成とカスタマイズ
- Agent Guide - カスタムエージェントの設定
- Changelog - バージョン履歴
- Security Policy - 脆弱性報告
ライセンス
MIT - 詳細はLICENSEをご覧ください。