agent-bot/takt

Fork 0

History

nrslib 7550b9ce17 update README for v0.4.0

2026-02-04 04:25:04 +09:00

agents.md

docs: README・ガイドを現行アーキテクチャに合わせて全面修正

2026-01-30 21:44:12 +09:00

data-flow-diagrams.md

refactor

2026-02-02 13:06:12 +09:00

data-flow.md

refactor

2026-02-02 17:11:42 +09:00

plan.md

プロンプトを見通しやすく変更

2026-02-04 03:33:48 +09:00

README.ja.md

update README for v0.4.0

2026-02-04 04:25:04 +09:00

workflows.md

カテゴリ分けの作成 #85 workflowの修正

2026-02-03 10:23:49 +09:00

README.ja.md

TAKT

Task Agent Koordination Tool - AIエージェントを「安全に」「責任を持って」運用するための協調制御システム

TAKTは、Claude CodeやCodexなどのAIエージェントを、組織のルールとワークフローに従って協調させます。誰が責任を持つか・どこまで許可するか・失敗時にどう戻すかを明確にしながら、複雑な開発タスクを自動化します。

TAKTはTAKT自身で開発されています（ドッグフーディング）。

TAKTが向いているチーム

CI/CDにAIを組み込みたいが、暴走が怖い — ワークフロー定義で制御範囲を明確化
PRの自動生成をしたいが、監査ログが必要 — 全ての実行履歴を記録・追跡可能
複数のAIモデルを使い分けたいが、統一的に管理したい — Claude/Codex/モックを同じワークフローで制御
エージェントの失敗を再現・デバッグしたい — セッションログとレポートで完全な履歴を保持

TAKTとは何でないか

自律型AIエンジニアの代替ではありません — TAKT自身が実装を完結するのではなく、複数のエージェントを統治・協調させます
Claude Code Swarmの競合ではありません — Swarmの実行力を活かしつつ、TAKTはワークフロー/権限/監査ログなど「運用のガードレール」を提供します
単なるワークフローエンジンではありません — 非決定性、責任所在、監査要件、再現性といったAI特有の課題に対応した設計です

必要条件

次のいずれかを選択してください。

プロバイダーCLIを使用: Claude Code または Codex をインストール
API直接利用: Anthropic API Key または OpenAI API Key（CLI不要）

追加で必要なもの:

GitHub CLI (gh) — takt #N（GitHub Issue実行）を使う場合のみ必要

料金について: API Key を使用する場合、TAKT は Claude API（Anthropic）または OpenAI API を直接呼び出します。料金体系は Claude Code や Codex を使った場合と同じです。特に CI/CD で自動実行する場合、API 使用量が増えるため、コストに注意してください。

インストール

npm install -g takt

クイックスタート

# 対話モードでAIとタスク要件を詰めてから実行
takt

# GitHub Issueをタスクとして実行（どちらも同じ）
takt #6
takt --issue 6

# パイプライン実行（非対話・スクリプト/CI向け）
takt --pipeline --task "バグを修正して" --auto-pr

使い方

対話モード

AI との会話でタスク内容を詰めてから実行するモード。タスクの要件が曖昧な場合や、AI と相談しながら内容を整理したい場合に便利です。

# 対話モードを開始（引数なし）
takt

# 最初のメッセージを指定（短い単語のみ）
takt hello

注意: スペースを含む文字列や Issue 参照（#6）、--task / --issue オプションを指定すると、対話モードをスキップして直接タスク実行されます。

フロー:

ワークフロー選択
AI との会話でタスク内容を整理
/go でタスク指示を確定（/go 追加の指示 のように指示を追加することも可能）
実行（worktree 作成、ワークフロー実行、PR 作成）

実行例

$ takt

Select workflow:
  ❯ 🎼 default (current)
    📁 Development/
    📁 Research/
    Cancel

対話モード - タスク内容を入力してください。コマンド: /go（実行）, /cancel（終了）

> ユーザー認証機能を追加したい

[AI が要件を確認・整理]

> /go

提案されたタスク指示:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ユーザー認証機能を実装する。

要件:
- メールアドレスとパスワードによるログイン機能
- JWT トークンを使った認証
- パスワードのハッシュ化（bcrypt）
- ログイン・ログアウト API エンドポイント
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

このタスク指示で進めますか？ (Y/n) y

? Create worktree? (Y/n) y

[ワークフロー実行開始...]

直接タスク実行

タスク内容が明確な場合は、対話モードをスキップして直接実行できます。

# タスク内容を直接指定（スペースを含む文字列）
takt "ログイン機能を追加する"

# --task オプションでタスク内容を指定
takt --task "バグを修正"

# ワークフロー指定
takt "認証機能を追加" --workflow expert

# PR 自動作成
takt "バグを修正" --auto-pr

GitHub Issue タスク

GitHub Issue を直接タスクとして実行できます。Issue のタイトル、本文、ラベル、コメントが自動的にタスク内容として取り込まれます。

# Issue番号を指定して実行
takt #6
takt --issue 6

# Issue + ワークフロー指定
takt #6 --workflow expert

# Issue + PR自動作成
takt #6 --auto-pr

必要条件: GitHub CLI (gh) がインストールされ、認証済みであること。

タスク管理（add / run / watch / list）

タスクファイル（.takt/tasks/）を使ったバッチ処理。複数のタスクを積んでおいて、後でまとめて実行する使い方に便利です。

タスクを追加（`takt add`）

# AI会話でタスクの要件を詰めてからタスクを追加
takt add

# GitHub IssueからタスクAdd（Issue番号がブランチ名に反映される）
takt add #28

タスクを実行（`takt run`）

# .takt/tasks/ の保留中タスクをすべて実行
takt run

タスクを監視（`takt watch`）

# .takt/tasks/ を監視してタスクを自動実行（常駐プロセス）
takt watch

タスクブランチを一覧表示（`takt list`）

# タスクブランチ一覧（マージ・削除）
takt list

パイプラインモード（CI/自動化向け）

--pipeline を指定すると非対話のパイプラインモードに入ります。ブランチ作成 → ワークフロー実行 → commit & push を自動で行います。CI/CD での自動化に適しています。

# タスクをパイプライン実行
takt --pipeline --task "バグを修正"

# パイプライン実行 + PR自動作成
takt --pipeline --task "バグを修正" --auto-pr

# Issue情報を紐付け
takt --pipeline --issue 99 --auto-pr

# ワークフロー・ブランチ指定
takt --pipeline --task "バグを修正" -w magi -b feat/fix-bug

# リポジトリ指定（PR作成時）
takt --pipeline --task "バグを修正" --auto-pr --repo owner/repo

# ワークフロー実行のみ（ブランチ作成・commit・pushをスキップ）
takt --pipeline --task "バグを修正" --skip-git

# 最小限の出力モード（CI向け）
takt --pipeline --task "バグを修正" --quiet

パイプラインモードでは --auto-pr を指定しない限り PR は作成されません。

GitHub との統合: GitHub Actions で TAKT を使う場合は、takt-action を参照してください。PR レビューやタスク実行を自動化できます。詳細は CI/CD 連携セクションを参照してください。

その他のコマンド

# ワークフローを対話的に切り替え
takt switch

# ビルトインのワークフロー/エージェントを~/.takt/にコピーしてカスタマイズ
takt eject

# エージェントの会話セッションをクリア
takt clear

# パーミッションモードを設定
takt config

ワークフロー	おすすめ用途
`default`	本格的な開発タスク。TAKT自身の開発で使用。アーキテクト＋セキュリティの並列レビュー付き多段階レビュー。
`minimal`	簡単な修正やシンプルなタスク。基本的なレビュー付きの最小限のワークフロー。
`review-fix-minimal`	レビュー＆修正ワークフロー。レビューフィードバックに基づく反復的な改善に特化。
`research`	調査・リサーチ。質問せずに自律的にリサーチを実行。

主要なオプション

オプション	説明
`--pipeline`	パイプライン（非対話）モードを有効化 — CI/自動化に必須
`-t, --task <text>`	タスク内容（GitHub Issueの代わり）
`-i, --issue <N>`	GitHub Issue番号（対話モードでは `#N` と同じ）
`-w, --workflow <name or path>`	ワークフロー名、またはワークフローYAMLファイルのパス
`-b, --branch <name>`	ブランチ名指定（省略時は自動生成）
`--auto-pr`	PR作成（対話: 確認スキップ、パイプライン: PR有効化）
`--skip-git`	ブランチ作成・commit・pushをスキップ（パイプラインモード、ワークフロー実行のみ）
`--repo <owner/repo>`	リポジトリ指定（PR作成時）
`--create-worktree <yes\|no>`	worktree確認プロンプトをスキップ
`-q, --quiet`	最小限の出力モード: AIの出力を抑制（CI向け）
`--provider <name>`	エージェントプロバイダーを上書き（claude\|codex\|mock）
`--model <name>`	エージェントモデルを上書き

ワークフロー

TAKTはYAMLベースのワークフロー定義とルールベースルーティングを使用します。ビルトインワークフローはパッケージに埋め込まれており、~/.takt/workflows/ のユーザーワークフローが優先されます。takt eject でビルトインを~/.takt/にコピーしてカスタマイズできます。

注記 (v0.4.0): ワークフローコンポーネントの内部用語が "step" から "movement" に変更されました。ユーザー向けのワークフローファイルは引き続き互換性がありますが、ワークフローをカスタマイズする場合、YAMLファイルで movements: の代わりに movements: が使用されることがあります。機能は同じです。

ワークフローの例

name: default
max_iterations: 10
initial_movement: plan

movements:
  - name: plan
    agent: ../agents/default/planner.md
    model: opus
    edit: false
    rules:
      - condition: 計画完了
        next: implement
    instruction_template: |
      リクエストを分析し、実装計画を作成してください。

  - name: implement
    agent: ../agents/default/coder.md
    edit: true
    permission_mode: edit
    rules:
      - condition: 実装完了
        next: review
      - condition: 進行不可
        next: ABORT
    instruction_template: |
      計画に基づいて実装してください。

  - name: review
    agent: ../agents/default/architecture-reviewer.md
    edit: false
    rules:
      - condition: 承認
        next: COMPLETE
      - condition: 修正が必要
        next: implement
    instruction_template: |
      アーキテクチャとコード品質の観点で実装をレビューしてください。

エージェントレスムーブメント

agent フィールドは省略可能です。省略した場合、ムーブメントはシステムプロンプトなしで instruction_template のみを使って実行されます。これはエージェントの動作カスタマイズが不要なシンプルなタスクに便利です。

  - name: summarize
    # agent未指定 — instruction_templateのみを使用
    edit: false
    rules:
      - condition: 要約完了
        next: COMPLETE
    instruction_template: |
      レポートを読んで簡潔な要約を提供してください。

また、agent の値としてインラインシステムプロンプトを記述することもできます（指定されたファイルが存在しない場合）:

  - name: review
    agent: "あなたはコードレビュアーです。可読性と保守性に焦点を当ててください。"
    edit: false
    instruction_template: |
      コード品質をレビューしてください。

パラレルムーブメント

ムーブメント内でサブムーブメントを並列実行し、集約条件で評価できます:

  - name: reviewers
    parallel:
      - name: arch-review
        agent: ../agents/default/architecture-reviewer.md
        rules:
          - condition: approved
          - condition: needs_fix
        instruction_template: |
          アーキテクチャとコード品質をレビューしてください。
      - name: security-review
        agent: ../agents/default/security-reviewer.md
        rules:
          - condition: approved
          - condition: needs_fix
        instruction_template: |
          セキュリティ脆弱性をレビューしてください。
    rules:
      - condition: all("approved")
        next: supervise
      - condition: any("needs_fix")
        next: fix

all("X"): すべてのサブムーブメントが条件Xにマッチした場合にtrue
any("X"): いずれかのサブムーブメントが条件Xにマッチした場合にtrue
サブムーブメントの rules は可能な結果を定義しますが、next は省略可能（親が遷移を制御）

ルール条件の種類

種類	構文	説明
タグベース	`"条件テキスト"`	エージェントが `[STEP:N]` タグを出力し、インデックスでマッチ
AI判定	`ai("条件テキスト")`	AIが条件をエージェント出力に対して評価
集約	`all("X")` / `any("X")`	パラレルサブムーブメントの結果を集約

ビルトインワークフロー

TAKTには複数のビルトインワークフローが同梱されています:

ワークフロー	説明
`default`	フル開発ワークフロー: 計画 → アーキテクチャ設計 → 実装 → AI レビュー → 並列レビュー（アーキテクト＋セキュリティ）→ スーパーバイザー承認。各レビュー段階に修正ループあり。
`minimal`	クイックワークフロー: 計画 → 実装 → レビュー → スーパーバイザー。高速イテレーション向けの最小構成。
`review-fix-minimal`	レビュー重視ワークフロー: レビュー → 修正 → スーパーバイザー。レビューフィードバックに基づく反復改善向け。
`research`	リサーチワークフロー: プランナー → ディガー → スーパーバイザー。質問せずに自律的にリサーチを実行。
`expert`	フルスタック開発ワークフロー: アーキテクチャ、フロントエンド、セキュリティ、QA レビューと修正ループ。
`expert-cqrs`	フルスタック開発ワークフロー（CQRS+ES特化）: CQRS+ES、フロントエンド、セキュリティ、QA レビューと修正ループ。
`magi`	エヴァンゲリオンにインスパイアされた審議システム。3つの AI ペルソナ（MELCHIOR、BALTHASAR、CASPER）が分析し投票。
`review-only`	変更を加えない読み取り専用のコードレビューワークフロー。

takt switch でワークフローを切り替えられます。

ビルトインエージェント

エージェント	説明
planner	タスク分析、仕様調査、実装計画
coder	機能の実装、バグ修正
ai-antipattern-reviewer	AI特有のアンチパターンレビュー（存在しないAPI、誤った仮定、スコープクリープ）
architecture-reviewer	アーキテクチャとコード品質のレビュー、仕様準拠の検証
security-reviewer	セキュリティ脆弱性の評価
supervisor	最終検証、バリデーション、承認

カスタムエージェント

Markdown ファイルでエージェントプロンプトを作成:

# ~/.takt/agents/my-agents/reviewer.md

あなたはセキュリティに特化したコードレビュアーです。

## 役割
- セキュリティ脆弱性をチェック
- 入力バリデーションを検証
- 認証ロジックをレビュー

モデル選択

model フィールド（ワークフローのムーブメント、エージェント設定、グローバル設定）はプロバイダー（Claude Code CLI / Codex SDK）にそのまま渡されます。TAKTはモデルエイリアスの解決を行いません。

Claude Code

Claude Code はエイリアス（opus、sonnet、haiku、opusplan、default）およびフルモデル名（例: claude-sonnet-4-5-20250929）をサポートしています。利用可能なモデルは Claude Code ドキュメントを参照してください。

Codex

モデル文字列はCodex SDKに渡されます。未指定の場合は codex がデフォルトです。利用可能なモデルはCodexのドキュメントを参照してください。

プロジェクト構造

~/.takt/                    # グローバル設定ディレクトリ
├── config.yaml             # グローバル設定（プロバイダー、モデル、ワークフロー等）
├── workflows/              # ユーザーワークフロー定義（ビルトインを上書き）
│   └── custom.yaml
└── agents/                 # ユーザーエージェントプロンプトファイル（.md）
    └── my-agent.md

.takt/                      # プロジェクトレベルの設定
├── config.yaml             # プロジェクト設定（現在のワークフロー等）
├── tasks/                  # 保留中のタスクファイル（.yaml, .md）
├── completed/              # 完了したタスクとレポート
├── reports/                # 実行レポート（自動生成）
│   └── {timestamp}-{slug}/
└── logs/                   # NDJSON 形式のセッションログ
    ├── latest.json         # 現在/最新セッションへのポインタ
    ├── previous.json       # 前回セッションへのポインタ
    └── {sessionId}.jsonl   # ワークフロー実行ごとの NDJSON セッションログ

ビルトインリソースはnpmパッケージ（dist/resources/）に埋め込まれています。~/.takt/ のユーザーファイルが優先されます。

グローバル設定

デフォルトのプロバイダーとモデルを ~/.takt/config.yaml で設定:

# ~/.takt/config.yaml
language: ja
default_workflow: default
log_level: info
provider: claude         # デフォルトプロバイダー: claude または codex
model: sonnet            # デフォルトモデル（オプション）

# API Key 設定（オプション）
# 環境変数 TAKT_ANTHROPIC_API_KEY / TAKT_OPENAI_API_KEY で上書き可能
anthropic_api_key: sk-ant-...  # Claude (Anthropic) を使う場合
# openai_api_key: sk-...       # Codex (OpenAI) を使う場合

trusted_directories:
  - /path/to/trusted/dir

# パイプライン実行設定（オプション）
# ブランチ名、コミットメッセージ、PRの本文をカスタマイズできます。
# pipeline:
#   default_branch_prefix: "takt/"
#   commit_message_template: "feat: {title} (#{issue})"
#   pr_body_template: |
#     ## Summary
#     {issue_body}
#     Closes #{issue}

API Key の設定方法:

環境変数で設定:

export TAKT_ANTHROPIC_API_KEY=sk-ant-...  # Claude の場合
# または
export TAKT_OPENAI_API_KEY=sk-...         # Codex の場合

設定ファイルで設定: 上記の ~/.takt/config.yaml に anthropic_api_key または openai_api_key を記述

優先順位: 環境変数 > config.yaml の設定

注意事項:

API Key を設定した場合、Claude Code や Codex のインストールは不要です。TAKT が直接 Anthropic API または OpenAI API を呼び出します。
セキュリティ: config.yaml に API Key を記述した場合、このファイルを Git にコミットしないよう注意してください。環境変数での設定を使うか、.gitignore に ~/.takt/config.yaml を追加することを検討してください。

パイプラインテンプレート変数:

変数	使用可能箇所	説明
`{title}`	コミットメッセージ	Issueタイトル
`{issue}`	コミットメッセージ、PR本文	Issue番号
`{issue_body}`	PR本文	Issue本文
`{report}`	PR本文	ワークフロー実行レポート

モデル解決の優先順位:

ワークフローのムーブメントの model（最優先）
カスタムエージェントの model
グローバル設定の model
プロバイダーデフォルト（Claude: sonnet、Codex: codex）

詳細ガイド

タスクファイルの形式

TAKT は .takt/tasks/ 内のタスクファイルによるバッチ処理をサポートしています。.yaml/.yml と .md の両方のファイル形式に対応しています。

YAML形式（推奨、worktree/branch/workflowオプション対応）:

# .takt/tasks/add-auth.yaml
task: "認証機能を追加する"
worktree: true                  # 隔離された共有クローンで実行
branch: "feat/add-auth"         # ブランチ名（省略時は自動生成）
workflow: "default"             # ワークフロー指定（省略時は現在のもの）

Markdown形式（シンプル、後方互換）:

# .takt/tasks/add-login-feature.md

アプリケーションにログイン機能を追加する。

要件:
- ユーザー名とパスワードフィールド
- フォームバリデーション
- 失敗時のエラーハンドリング

共有クローンによる隔離実行

YAMLタスクファイルでworktreeを指定すると、各タスクをgit clone --sharedで作成した隔離クローンで実行し、メインの作業ディレクトリをクリーンに保てます:

worktree: true - 隣接ディレクトリ（またはworktree_dir設定で指定した場所）に共有クローンを自動作成
worktree: "/path/to/dir" - 指定パスに作成
branch: "feat/xxx" - 指定ブランチを使用（省略時はtakt/{timestamp}-{slug}で自動生成）
worktree省略 - カレントディレクトリで実行（デフォルト）

Note

: YAMLフィールド名は後方互換のためworktreeのままです。内部的にはgit worktreeではなくgit clone --sharedを使用しています。git worktreeの.gitファイルにはgitdir:でメインリポジトリへのパスが記載されており、Claude Codeがそれを辿ってメインリポジトリをプロジェクトルートと認識してしまうためです。共有クローンは独立した.gitディレクトリを持つため、この問題が発生しません。

クローンは使い捨てです。タスク完了後に自動的にコミット＋プッシュし、クローンを削除します。ブランチが唯一の永続的な成果物です。takt list でブランチの一覧表示・マージ・削除ができます。

セッションログ

TAKTはセッションログをNDJSON（.jsonl）形式で.takt/logs/に書き込みます。各レコードはアトミックに追記されるため、プロセスが途中でクラッシュしても部分的なログが保持され、tail -fでリアルタイムに追跡できます。

.takt/logs/latest.json - 現在（または最新の）セッションへのポインタ
.takt/logs/previous.json - 前回セッションへのポインタ
.takt/logs/{sessionId}.jsonl - ワークフロー実行ごとのNDJSONセッションログ

レコード種別: workflow_start, step_start, step_complete, workflow_complete, workflow_abort

エージェントはprevious.jsonを読み取って前回の実行コンテキストを引き継ぐことができます。セッション継続は自動的に行われます — takt "タスク"を実行するだけで前回のセッションから続行されます。

カスタムワークフローの追加

~/.takt/workflows/ に YAML ファイルを追加するか、takt eject でビルトインをカスタマイズします:

# defaultワークフローを~/.takt/workflows/にコピーして編集
takt eject default

# ~/.takt/workflows/my-workflow.yaml
name: my-workflow
description: カスタムワークフロー
max_iterations: 5
initial_movement: analyze

movements:
  - name: analyze
    agent: ~/.takt/agents/my-agents/analyzer.md
    edit: false
    rules:
      - condition: 分析完了
        next: implement
    instruction_template: |
      このリクエストを徹底的に分析してください。

  - name: implement
    agent: ~/.takt/agents/default/coder.md
    edit: true
    permission_mode: edit
    pass_previous_response: true
    rules:
      - condition: 完了
        next: COMPLETE
    instruction_template: |
      分析に基づいて実装してください。

Note

: {task}、{previous_response}、{user_inputs} は自動的にインストラクションに注入されます。テンプレート内での位置を制御したい場合のみ、明示的なプレースホルダーが必要です。

エージェントをパスで指定する

ワークフロー定義ではファイルパスを使ってエージェントを指定します:

# ワークフローファイルからの相対パス
agent: ../agents/default/coder.md

# ホームディレクトリ
agent: ~/.takt/agents/default/coder.md

# 絶対パス
agent: /path/to/custom/agent.md

ワークフロー変数

instruction_templateで使用可能な変数:

変数	説明
`{task}`	元のユーザーリクエスト（テンプレートになければ自動注入）
`{iteration}`	ワークフロー全体のターン数（実行された全ムーブメント数）
`{max_iterations}`	最大イテレーション数
`{movement_iteration}`	ムーブメントごとのイテレーション数（このムーブメントが実行された回数）
`{previous_response}`	前のムーブメントの出力（テンプレートになければ自動注入）
`{user_inputs}`	ワークフロー中の追加ユーザー入力（テンプレートになければ自動注入）
`{report_dir}`	レポートディレクトリパス（例: `.takt/reports/20250126-143052-task-summary`）
`{report:filename}`	`{report_dir}/filename` に展開（例: `{report:00-plan.md}`）

ワークフローの設計

各ワークフローのムーブメントに必要な要素:

1. エージェント - システムプロンプトを含むMarkdownファイル:

agent: ../agents/default/coder.md    # エージェントプロンプトファイルのパス
agent_name: coder                    # 表示名（オプション）

2. ルール - ムーブメントから次のムーブメントへのルーティングを定義。インストラクションビルダーがステータス出力ルールを自動注入するため、エージェントはどのタグを出力すべきか把握できます:

rules:
  - condition: "実装完了"
    next: review
  - condition: "進行不可"
    next: ABORT

特殊な next 値: COMPLETE（成功）、ABORT（失敗）

3. ムーブメントオプション:

オプション	デフォルト	説明
`edit`	-	ムーブメントがプロジェクトファイルを編集できるか（`true`/`false`）
`pass_previous_response`	`true`	前のムーブメントの出力を`{previous_response}`に渡す
`allowed_tools`	-	エージェントが使用できるツール一覧（Read, Glob, Grep, Edit, Write, Bash等）
`provider`	-	このムーブメントのプロバイダーを上書き（`claude`または`codex`）
`model`	-	このムーブメントのモデルを上書き
`permission_mode`	-	パーミッションモード: `readonly`、`edit`、`full`（プロバイダー非依存）
`report`	-	自動生成レポートのファイル設定（name, format）

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();

コントリビュート

詳細はCONTRIBUTING.mdを参照。

CI/CD連携

GitHub Actions

TAKTはPRレビューやタスク実行を自動化するGitHub Actionを提供しています。詳細は takt-action を参照してください。

ワークフロー例 (このリポジトリの .github/workflows/takt-action.yml を参照):

name: TAKT

on:
  issue_comment:
    types: [created]

jobs:
  takt:
    if: contains(github.event.comment.body, '@takt')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
      pull-requests: write

    movements:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Run TAKT
        uses: nrslib/takt-action@main
        with:
          anthropic_api_key: ${{ secrets.TAKT_ANTHROPIC_API_KEY }}
          github_token: ${{ secrets.GITHUB_TOKEN }}

コスト警告: TAKTはAI API（ClaudeまたはOpenAI）を使用するため、特にCI/CD環境でタスクが自動実行される場合、かなりのコストが発生する可能性があります。API使用量を監視し、請求アラートを設定してください。

その他のCIシステム

GitHub以外のCIシステムでは、パイプラインモードを使用します:

# taktをインストール
npm install -g takt

# パイプラインモードで実行
takt --pipeline --task "バグ修正" --auto-pr --repo owner/repo

認証には TAKT_ANTHROPIC_API_KEY または TAKT_OPENAI_API_KEY 環境変数を設定してください（TAKT 独自のプレフィックス付き）。

# Claude (Anthropic) を使う場合
export TAKT_ANTHROPIC_API_KEY=sk-ant-...

# Codex (OpenAI) を使う場合
export TAKT_OPENAI_API_KEY=sk-...

ドキュメント

Workflow Guide - ワークフローの作成とカスタマイズ
Agent Guide - カスタムエージェントの設定
Changelog - バージョン履歴
Security Policy - 脆弱性報告
ブログ: TAKT - AIエージェントオーケストレーション - 設計思想と実践的な使い方ガイド

ライセンス

MIT - 詳細はLICENSEをご覧ください。

README.ja.md Unescape Escape

TAKT

TAKTが向いているチーム

TAKTとは何でないか

必要条件

インストール

クイックスタート

使い方

対話モード

実行例

直接タスク実行

GitHub Issue タスク

タスク管理（add / run / watch / list）

タスクを追加（takt add）

タスクを実行（takt run）

タスクを監視（takt watch）

タスクブランチを一覧表示（takt list）

パイプラインモード（CI/自動化向け）

その他のコマンド

おすすめワークフロー

主要なオプション

ワークフロー

ワークフローの例

エージェントレスムーブメント

パラレルムーブメント

ルール条件の種類

ビルトインワークフロー

ビルトインエージェント

カスタムエージェント

モデル選択

Claude Code

Codex

プロジェクト構造

グローバル設定

詳細ガイド

タスクファイルの形式

共有クローンによる隔離実行

セッションログ

カスタムワークフローの追加

エージェントをパスで指定する

ワークフロー変数

ワークフローの設計

API使用例

コントリビュート

CI/CD連携

GitHub Actions

その他のCIシステム

ドキュメント

ライセンス

README.ja.md

タスクを追加（`takt add`）

タスクを実行（`takt run`）

タスクを監視（`takt watch`）

タスクブランチを一覧表示（`takt list`）