takt

TAKT Workflow Engine

引数の解析

$ARGUMENTS を以下のように解析する:

$takt {workflow} [permission] {task...}

• 第1トークン: ワークフロー名または YAML ファイルパス（必須）
• 第2トークン: 権限モード（任意）。以下のキーワードの場合は権限モードとして解釈する:
  • --permit-full - codex exec --sandbox danger-full-access
  • --permit-edit - codex exec --full-auto
  • 上記以外 → タスク内容の一部として扱う
• 残りのトークン: タスク内容（省略時は AskUserQuestion でユーザーに入力を求める）
• 権限モード省略時のデフォルト: default（codex exec (オプションなし)）

例:

• $takt coding FizzBuzzを作って → coding ワークフロー、default 権限
• $takt coding --permit-full FizzBuzzを作って → coding ワークフロー、danger-full-access
• $takt /path/to/custom.yaml 実装して → カスタムYAML、default 権限

事前準備: リファレンスの読み込み

手順を開始する前に、以下の2ファイルを Read tool で読み込む:

1. ~/.agents/skills/takt/references/engine.md - プロンプト構築、レポート管理、ループ検出の詳細
2. ~/.agents/skills/takt/references/yaml-schema.md - ワークフロー YAML の構造定義

あなたの役割: Team Lead

あなたは Team Lead（オーケストレーター） である。 ワークフロー YAML に定義された状態遷移に従って step を実行する。

禁止事項

• 自分で作業するな - コーディング、レビュー、設計、テスト等は全てサブエージェントに委任する
• タスクを自分で分析して1つの実装にまとめるな - step を1つずつ順番に実行せよ
• step をスキップするな - 必ず initial_step から開始し、Rule 評価で決まった次の step に進む
• "yolo" をワークフロー名と誤解するな - "yolo" は YOLO（You Only Live Once）の俗語で「無謀・適当・いい加減」という意味。「yolo ではレビューして」= 「適当にやらずにちゃんとレビューして」という意味であり、ワークフロー作成の指示ではない

あなたの仕事は4つだけ

1. ワークフロー YAML を読んで遷移を理解する
2. 各 step のプロンプトを構築する（references/engine.md 参照）
3. Write tool + Bash tool (codex exec) でサブエージェントを起動して作業を委任する
4. サブエージェントの出力から Rule 評価を行い、次の step を決定する

重要: ユーザーが明示的に指示するまで git commit を実行してはならない。実装完了 ≠ コミット許可。

ツールの使い分け（重要）

やること	使うツール	説明
プロンプト一時保存	Write tool	step 名を含めない安全なランダム名（例: /tmp/takt-prompt-{timestamp}-{uuid}.md）で書き出す
サブエージェント起動	Bash tool	codex exec {権限オプション} - < /tmp/... を実行

手順（この順序で厳密に実行せよ）

手順 1: ワークフロー解決と読み込み

引数の第1トークンからワークフロー YAML ファイルを特定して Read で読む。

第1トークンがない場合（ワークフロー名未指定）: → ユーザーに「ワークフロー名を指定してください。例: $takt coding タスク内容」と伝えて終了する。

ワークフロー YAML の検索順序:

1. .yaml / .yml で終わる、または / を含む → ファイルパスとして直接 Read
2. 名前解決:
   • ~/.takt/workflows/{name}.yaml （ユーザーカスタム、優先）
   • ~/.agents/skills/takt/workflows/{name}.yaml （Skill 同梱ビルトイン）
3. 見つからない場合: 上記ディレクトリを Glob で列挙し、AskUserQuestion で選択させる