README: coding ピース、新エージェント、未記載コマンド(prompt/reset categories/list non-interactive/eject --global)を追加

This commit is contained in:
nrslib 2026-02-06 14:18:33 +09:00
parent 466d753df8
commit 093520ab65
2 changed files with 40 additions and 2 deletions

View File

@ -190,6 +190,12 @@ takt watch
```bash
# List task branches (merge/delete)
takt list
# Non-interactive mode (for CI/scripts)
takt list --non-interactive
takt list --non-interactive --action diff --branch takt/my-branch
takt list --non-interactive --action delete --branch takt/my-branch --yes
takt list --non-interactive --format json
```
### Pipeline Mode (for CI/Automation)
@ -229,17 +235,26 @@ In pipeline mode, PRs are not created unless `--auto-pr` is specified.
# Interactively switch pieces
takt switch
# Copy builtin pieces/agents to ~/.takt/ for customization
# Copy builtin pieces/agents to project .takt/ for customization
takt eject
# Copy to ~/.takt/ (global) instead
takt eject --global
# Clear agent conversation sessions
takt clear
# Deploy builtin pieces/agents as Claude Code Skill
takt export-cc
# Preview assembled prompts for each movement and phase
takt prompt [piece]
# Configure permission mode
takt config
# Reset piece categories to builtin defaults
takt reset categories
```
### Recommended Pieces
@ -394,6 +409,7 @@ TAKT includes multiple builtin pieces:
| `expert` | Full-stack development piece: architecture, frontend, security, QA reviews with fix loops. |
| `expert-cqrs` | Full-stack development piece (CQRS+ES specialized): CQRS+ES, frontend, security, QA reviews with fix loops. |
| `magi` | Deliberation system inspired by Evangelion. Three AI personas (MELCHIOR, BALTHASAR, CASPER) analyze and vote. |
| `coding` | Lightweight development piece: architect-planner → implement → parallel review (AI antipattern + architecture) → fix. Fast feedback loop without supervisor. |
| `passthrough` | Thinnest wrapper. Pass task directly to coder as-is. No review. |
| `review-only` | Read-only code review piece that makes no changes. |
@ -406,10 +422,13 @@ Use `takt switch` to switch pieces.
| Agent | Description |
|-------|-------------|
| **planner** | Task analysis, spec investigation, implementation planning |
| **architect-planner** | Task analysis and design planning: investigates code, resolves unknowns, creates implementation plans |
| **coder** | Feature implementation, bug fixing |
| **ai-antipattern-reviewer** | AI-specific antipattern review (non-existent APIs, incorrect assumptions, scope creep) |
| **architecture-reviewer** | Architecture and code quality review, spec compliance verification |
| **qa-reviewer** | Test coverage and quality assurance review |
| **security-reviewer** | Security vulnerability assessment |
| **conductor** | Phase 3 judgment specialist: reads reports/responses and outputs status tags |
| **supervisor** | Final validation, approval |
## Custom Agents

View File

@ -186,6 +186,12 @@ takt watch
```bash
# タスクブランチ一覧(マージ・削除)
takt list
# 非対話モードCI/スクリプト向け)
takt list --non-interactive
takt list --non-interactive --action diff --branch takt/my-branch
takt list --non-interactive --action delete --branch takt/my-branch --yes
takt list --non-interactive --format json
```
### パイプラインモードCI/自動化向け)
@ -225,17 +231,26 @@ takt --pipeline --task "バグを修正" --quiet
# ピースを対話的に切り替え
takt switch
# ビルトインのピース/エージェントを~/.takt/にコピーしてカスタマイズ
# ビルトインのピース/エージェントをプロジェクト .takt/ にコピーしてカスタマイズ
takt eject
# ~/.takt/(グローバル)にコピー
takt eject --global
# エージェントの会話セッションをクリア
takt clear
# ビルトインピース・エージェントを Claude Code Skill としてデプロイ
takt export-cc
# 各ムーブメント・フェーズの組み立て済みプロンプトをプレビュー
takt prompt [piece]
# パーミッションモードを設定
takt config
# ピースカテゴリをビルトインのデフォルトにリセット
takt reset categories
```
### おすすめピース
@ -390,6 +405,7 @@ TAKTには複数のビルトインピースが同梱されています:
| `expert` | フルスタック開発ピース: アーキテクチャ、フロントエンド、セキュリティ、QA レビューと修正ループ。 |
| `expert-cqrs` | フルスタック開発ピースCQRS+ES特化: CQRS+ES、フロントエンド、セキュリティ、QA レビューと修正ループ。 |
| `magi` | エヴァンゲリオンにインスパイアされた審議システム。3つの AI ペルソナMELCHIOR、BALTHASAR、CASPERが分析し投票。 |
| `coding` | 軽量開発ピース: architect-planner → 実装 → 並列レビューAI アンチパターン+アーキテクチャ)→ 修正。スーパーバイザーなしの高速フィードバックループ。 |
| `passthrough` | 最小構成。タスクをそのまま coder に渡す薄いラッパー。レビューなし。 |
| `review-only` | 変更を加えない読み取り専用のコードレビューピース。 |
@ -402,10 +418,13 @@ TAKTには複数のビルトインピースが同梱されています:
| エージェント | 説明 |
|------------|------|
| **planner** | タスク分析、仕様調査、実装計画 |
| **architect-planner** | タスク分析と設計計画: コード調査、不明点の解決、実装計画の作成 |
| **coder** | 機能の実装、バグ修正 |
| **ai-antipattern-reviewer** | AI特有のアンチパターンレビュー存在しないAPI、誤った仮定、スコープクリープ |
| **architecture-reviewer** | アーキテクチャとコード品質のレビュー、仕様準拠の検証 |
| **qa-reviewer** | テストカバレッジと品質保証のレビュー |
| **security-reviewer** | セキュリティ脆弱性の評価 |
| **conductor** | Phase 3 判定専用: レポートやレスポンスを読み取り、ステータスタグを出力 |
| **supervisor** | 最終検証、バリデーション、承認 |
## カスタムエージェント