From takt
TAKTファセット(Persona/Policy/Instruction/Knowledge/Output Contract)の 個別作成・編集スキル。各ファセットのスタイルガイドに準拠した単体ファイルを生成する。 references/taktにあるスタイルガイド・ビルトインファセット群を参照資料として活用し、 ファセット種別の判断、テンプレート選択、品質チェックを行う。 トリガー:「ペルソナを作りたい」「ポリシーを追加」「インストラクションを書く」 「ナレッジを定義」「出力契約を作成」「ファセットを編集」「takt facet」 「レビュアーのペルソナ」「コーディングポリシー」
npx claudepluginhub j5ik2o/ai-tools --plugin taktThis skill uses the workspace's default tool permissions.
TAKTの5種類のファセットファイルを個別に作成・編集する。
SKILL.en.mdSKILL.ja.mdreferences/takt/builtins/ja/INSTRUCTION_STYLE_GUIDE.mdreferences/takt/builtins/ja/KNOWLEDGE_STYLE_GUIDE.mdreferences/takt/builtins/ja/OUTPUT_CONTRACT_STYLE_GUIDE.mdreferences/takt/builtins/ja/PERSONA_STYLE_GUIDE.mdreferences/takt/builtins/ja/POLICY_STYLE_GUIDE.mdreferences/takt/builtins/ja/STYLE_GUIDE.mdreferences/takt/builtins/ja/config.yamlreferences/takt/builtins/ja/facets/instructions/ai-fix.mdreferences/takt/builtins/ja/facets/instructions/ai-review.mdreferences/takt/builtins/ja/facets/instructions/arbitrate.mdreferences/takt/builtins/ja/facets/instructions/architect.mdreferences/takt/builtins/ja/facets/instructions/dual-team-leader-implement.mdreferences/takt/builtins/ja/facets/instructions/fix-supervisor.mdreferences/takt/builtins/ja/facets/instructions/fix.mdreferences/takt/builtins/ja/facets/instructions/gather-review.mdreferences/takt/builtins/ja/facets/instructions/implement-after-tests.mdreferences/takt/builtins/ja/facets/instructions/implement-e2e-test.mdreferences/takt/builtins/ja/facets/instructions/implement-terraform.mdTAKTピース(ワークフローYAML)の作成・カスタマイズスキル。Faceted Prompting (Persona/Policy/Instruction/Knowledge/Output Contract)に基づくファセット群の 生成を含む。references/taktにあるtaktのソースコード・ドキュメント・ビルトインピース群を 参照資料として活用する。ユーザーの要件をヒアリングし、movement構成、ルール設計、 ファセットファイル生成を一括で行う。 トリガー:「ピースを作りたい」「ワークフローを定義」「taktのピースを作成」 「新しいtaktピースを作って」「takt piece」「ワークフローYAML」
Orchestrates multi-step implementation planning from a markdown spec: research, stakeholder interviews, spec synthesis, plan, external review, and sectioned docs. Use for complex features.
Creates detailed sectionized TDD implementation plans through research, stakeholder interviews, and multi-LLM reviews. Use for features needing thorough pre-implementation analysis.
Share bugs, ideas, or general feedback.
TAKTの5種類のファセットファイルを個別に作成・編集する。
前提 takt バージョン: v0.31.0
ファセット作成時は references/takt/builtins/ja/ の資料を参照する。
| 資料 | パス | 用途 |
|---|---|---|
| スタイルガイド総合 | references/takt/builtins/ja/STYLE_GUIDE.md | 各ファセットの位置づけ |
| ペルソナガイド | references/takt/builtins/ja/PERSONA_STYLE_GUIDE.md | ペルソナ記述規約 |
| ポリシーガイド | references/takt/builtins/ja/POLICY_STYLE_GUIDE.md | ポリシー記述規約 |
| インストラクションガイド | references/takt/builtins/ja/INSTRUCTION_STYLE_GUIDE.md | インストラクション記述規約 |
| 出力契約ガイド | references/takt/builtins/ja/OUTPUT_CONTRACT_STYLE_GUIDE.md | 出力契約記述規約 |
| Faceted Prompting | references/takt/docs/faceted-prompting.ja.md | 5ファセット設計の理論 |
| テンプレート | references/takt/builtins/ja/templates/ | 各ファセットのテンプレート |
| ビルトインファセット | references/takt/builtins/ja/facets/{personas,policies,instructions,knowledge,output-contracts}/ | 既存ファセット例 |
重要: ファセット作成前に該当するスタイルガイドを必ず読む。
ユーザーの要件から、作成すべきファセット種別を判定する。
この内容は…
├── 特定エージェントのidentity・専門知識 → Persona
├── 複数エージェントが共有する行動規範 → Policy
├── ムーブメント固有の実行手順 → Instruction
├── 判断の前提となる参照情報 → Knowledge
└── エージェント出力の構造定義 → Output Contract
| ファセット | 配置先 | 対象 | キー判断 |
|---|---|---|---|
| Persona | system prompt | 1エージェント | 「この知識はこのエージェント固有か?」 |
| Policy | user message内 | 複数エージェント | 「複数エージェントが同じルールに従うか?」 |
| Instruction | Phase 1 message | 1ムーブメント | 「この手順はこのムーブメント固有か?」 |
| Knowledge | user message内 | 1+エージェント | 「判断の前提となる参照情報か?」 |
| Output Contract | Phase 2 message | 1レポート | 「後続が{report:filename}で参照するか?」 |
同種のビルトインファセットを確認し、再利用できるか判断する。
| ファセット | ビルトイン例 |
|---|---|
| Persona | coder, planner, architecture-reviewer, qa-reviewer, supervisor, security-reviewer, frontend-reviewer, cqrs-es-reviewer, requirements-reviewer, testing-reviewer, terraform-reviewer, dual-supervisor |
| Policy | coding, review, testing, qa, ai-antipattern |
| Instruction | plan, implement, implement-after-tests, write-tests-first, team-leader-implement, dual-team-leader-implement, review-arch, review-qa, review-security, review-frontend, review-cqrs-es, review-requirements, review-test, review-terraform, supervise, fix, ai-review, ai-fix, loop-monitor-ai-fix, loop-monitor-reviewers-fix |
| Knowledge | architecture, backend, cqrs-es, frontend, security, task-decomposition, takt, terraform-aws |
| Output Contract | plan, architecture-review, ai-review, qa-review, security-review, frontend-review, cqrs-es-review, requirements-review, testing-review, terraform-review, summary, validation |
再利用判断: ビルトインで足りる場合はカスタムファセットを作らない。
テンプレート: templates/personas/{simple,expert,character}.md
| テンプレート | 用途 | 例 |
|---|---|---|
simple.md | ドメイン知識なし | coder, planner |
expert.md | ドメイン知識あり | architecture-reviewer |
character.md | 固有の人格・口調 | melchior, balthasar |
# {エージェント名}
{1-2文のロール定義。「あなたは〜です。」で始める}
## 役割の境界
**やること:**
- ...
**やらないこと:**
- ...(担当エージェント名を明記)
## 行動姿勢
- ...(3-8項目)
## ドメイン知識(expertのみ)
### {観点}
...
サイズ目安: simple 30-50行(上限100行)、expert 50-300行(上限550行)
禁止事項:
.takt/runs/等)テンプレート: templates/policies/policy.md
# {ポリシー名}
{1文の目的説明}
## 原則
| 原則 | 基準 |
|------|------|
| ... | ... |
## {ルールカテゴリ1}
{テーブル、コード例、箇条書きを自由に組み合わせ}
サイズ目安: 60-250行(上限300行)
禁止事項:
テンプレート: templates/instructions/{plan,implement,review,fix,supervise,...}.md
{目的宣言。1-2行、命令形}
**注意:** {条件付き注意事項(該当する場合)}
**やること:**
1. {手順1}
2. {手順2}
3. {手順3}
**必須出力(見出しを含める)**
## {出力セクション1}
- {内容}
## {出力セクション2}
- {内容}
サイズ目安: レビュー sub-step 5-12行、計画・修正 10-20行、実装・検証 30-50行
禁止事項:
{task}, {previous_response})の手動記述テンプレート変数(使用可能):
{iteration}, {max_movements}, {movement_iteration}{report_dir}, {report:filename}, {cycle_count}テンプレート: templates/knowledge/knowledge.md
# {ドメイン名}知識
## {トピック1}
{概要。1-2文}
| 基準 | 判定 |
|------|------|
| ... | ... |
### {サブトピック}
{コード例で具体的に}
## {トピック2}
| パターン | 例 | 問題 |
|---------|-----|------|
| ... | `{コード}` | ... |
検証アプローチ:
1. {手順}
特徴: 記述的(「こうなっている」)。ポリシーの「WHY」を提供する。
テンプレート: templates/reports/{plan,review,validation,summary,...}.md
```markdown
# {レポートタイトル}
## 結果: APPROVE / REJECT
## サマリー
{1-2文で結果を要約}
## 詳細
| 観点 | 結果 | 備考 |
|------|------|------|
```
**認知負荷軽減ルール:**
- APPROVE → サマリーのみ(5行以内)
- REJECT → 問題点を表形式で(30行以内)
サイズ目安: 10-25行(上限30行、認知負荷軽減ルール除く)
ステータスパターン: APPROVE / REJECT(二値)、APPROVE / IMPROVE / REJECT(三値)、完了(固定値)
レビュー出力契約の構造(v0.30.0〜):
family_tag 列を追加(指摘のカテゴリ分類)new(新規)→ persists(継続)→ resolved(解消済み)→ reopened(再開)禁止事項:
全ファセット共通のルールを確認する。
| ルール | 内容 |
|---|---|
| 見出し深さ | ### まで。#### 以下は不可 |
| コード例 | 良い例/悪い例のペア。// REJECT // OK コメント |
| 文体 | ペルソナ・ポリシー・ナレッジ: 常体。インストラクション: 丁寧語(命令調) |
| ファイル命名 | {name}.md、ハイフン区切り、英語小文字 |
| 配置 | ~/.takt/{facet-type}/ または プロジェクト固有の場所 |
作成したファセットの品質を確認する。
全ファセット共通:
#### 以下のネストがないかPersona:
Policy:
Instruction:
Knowledge:
Output Contract:
作成・編集したファイルは validate-takt-files.sh で機械的に検証できる:
bash .agents/skills/takt-facet/scripts/validate-takt-files.sh
検証項目:
name/initial_movement/movements)、initial_movement の movement 参照、ファセットファイル参照の実在# 見出し 必須、instruction/output-contract は内容存在オプション --pieces / --facets で対象を絞り込み可能。