菜单
既存のTAKTピースとファセットを分析し、改善提案を行うスキル。ピースYAMLの構造検証、 ファセット間の整合性チェック、スタイルガイド準拠の確認、未使用ファセットの検出、 ルール設計の最適化提案を実施する。references/taktのスタイルガイド・エンジン仕様を 基準として分析する。 トリガー：「ピースを分析」「taktの設定を確認」「ファセットの品質チェック」 「ピースのレビュー」「takt analyze」「ワークフローの改善提案」 「ピースの整合性チェック」「taktの問題を見つけて」
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
TAKTファセット（Persona/Policy/Instruction/Knowledge/Output Contract）の 個別作成・編集スキル。各ファセットのスタイルガイドに準拠した単体ファイルを生成する。 references/taktにあるスタイルガイド・ビルトインファセット群を参照資料として活用し、 ファセット種別の判断、テンプレート選択、品質チェックを行う。 トリガー：「ペルソナを作りたい」「ポリシーを追加」「インストラクションを書く」 「ナレッジを定義」「出力契約を作成」「ファセットを編集」「takt facet」 「レビュアーのペルソナ」「コーディングポリシー」
既存のTAKTワークフロー（ピースYAML・ファセット群）を最適化するスキル。 トークン消費削減、ムーブメント統合、ルール簡素化、ファセット再利用促進、 ループ制御の改善、並列化の提案を実施し、最適化後のファイルを直接生成する。 実行ログ（.takt/logs/*.jsonl）が提供された場合は、ルールマッチ分布・ループ頻度・ ABORT率などの実データに基づく最適化も行う。 takt-analyzeが「分析・レポート」に特化するのに対し、本スキルは「最適化の実行」に特化する。 references/taktのエンジン仕様・スタイルガイドを基準とする。 トリガー：「ピースを最適化」「taktの高速化」「ワークフローを軽くしたい」 「トークンを減らしたい」「ムーブメントを減らしたい」「takt optimize」 「ワークフローの効率化」「ファセットを整理したい」「ピースをスリムにして」 「taktのコスト削減」「ワークフローをシンプルにしたい」 「ログから最適化」「実行ログを分析して最適化」「taktのログを見て改善」
TAKTピース（ワークフローYAML）の作成・カスタマイズスキル。Faceted Prompting （Persona/Policy/Instruction/Knowledge/Output Contract）に基づくファセット群の 生成を含む。references/taktにあるtaktのソースコード・ドキュメント・ビルトインピース群を 参照資料として活用する。ユーザーの要件をヒアリングし、movement構成、ルール設計、 ファセットファイル生成を一括で行う。 トリガー：「ピースを作りたい」「ワークフローを定義」「taktのピースを作成」 「新しいtaktピースを作って」「takt piece」「ワークフローYAML」
| name | takt-analyze |
| description | 既存のTAKTピースとファセットを分析し、改善提案を行うスキル。ピースYAMLの構造検証、 ファセット間の整合性チェック、スタイルガイド準拠の確認、未使用ファセットの検出、 ルール設計の最適化提案を実施する。references/taktのスタイルガイド・エンジン仕様を 基準として分析する。 トリガー：「ピースを分析」「taktの設定を確認」「ファセットの品質チェック」 「ピースのレビュー」「takt analyze」「ワークフローの改善提案」 「ピースの整合性チェック」「taktの問題を見つけて」 |
既存のTAKTピースとファセットを分析し、問題点の検出と改善提案を行う。
| 資料 | パス | 用途 |
|---|---|---|
| YAMLスキーマ | references/takt/builtins/skill/references/yaml-schema.md | ピース構造の検証基準 |
| エンジン仕様 | references/takt/builtins/skill/references/engine.md | ルール評価・実行仕様 |
| スタイルガイド群 | references/takt/builtins/ja/*_STYLE_GUIDE.md | ファセット品質基準 |
| ビルトインピース | references/takt/builtins/ja/pieces/ | 構造パターンの参照 |
| ビルトインファセット | references/takt/builtins/ja/{personas,policies,instructions,knowledge,output-contracts}/ | ファセット品質の参照 |
ピースYAMLの構造的な問題を検出する。
チェック項目:
| チェック | 内容 | 重大度 |
|---|---|---|
| initial_movement存在 | initial_movementがmovements配列内に存在するか | Critical |
| 遷移先の有効性 | 全rules.nextが有効なムーブメント名 or COMPLETE/ABORTか | Critical |
| セクションマップ整合性 | セクションマップのキーとムーブメント内参照が一致するか | Critical |
| ファイルパス存在 | セクションマップのパスが実在するか | Critical |
| parallel構造 | 親ルールがall()/any()を使用、サブステップにnextがないか | Warning |
| edit権限 | edit: trueのムーブメントに適切なrequired_permission_modeがあるか | Info |
| session設定 | 実装系ムーブメントにsession: refreshがあるか | Info |
各ファセットがスタイルガイドに準拠しているか確認する。
Persona チェック:
####以下のネストがないPolicy チェック:
Instruction チェック:
{task}, {previous_response}を手動記述していないOutput Contract チェック:
```markdownコードブロックで囲まれているファセット間の責務が適切に分離されているか検出する。
| 違反パターン | 説明 | 修正方向 |
|---|---|---|
| ペルソナにポリシー詳細 | コード例・テーブル付きのルールがペルソナ内に | → ポリシーに移動 |
| ペルソナにピース概念 | ムーブメント名・レポートファイル名がペルソナ内に | → インストラクションに移動 |
| ポリシーに固有知識 | 特定エージェント固有の検出手法がポリシー内に | → ペルソナのドメイン知識に移動 |
| インストラクションに原則 | 共有コーディング原則がインストラクション内に | → ポリシーに移動 |
| 出力契約に手順 | 実行手順が出力契約内に | → インストラクションに移動 |
ルール条件の設計を評価する。
| チェック | 内容 |
|---|---|
| タグ vs AI判定 | タグベース条件で対応可能な箇所でai()を使用していないか |
| aggregate使用 | parallelの親でall()/any()を使用しているか |
| 到達不能ルール | どの条件にも該当しないケースがないか |
| ループリスク | fix→review等の循環にloop_monitorsがあるか |
| ABORT条件 | 失敗時のABORT遷移が適切に定義されているか |
カスタムファセットがビルトインで代替可能か検出する。
手順:
分析対象のピースYAMLを特定する。
探索順序:
1. ユーザー指定のパス
2. ~/.takt/pieces/ 内のカスタムピース
3. .takt/pieces/ 内のプロジェクトピース
ピースYAMLを読み込み、構造分析を実施する。
セクションマップとビルトイン参照から全ファセットを読み込み、スタイルガイドに照合する。
ファセット間の責務侵犯を検出する。
# TAKT分析レポート: {ピース名}
## サマリー
- Critical: {N件}
- Warning: {N件}
- Info: {N件}
## Critical（必須修正）
| # | カテゴリ | 場所 | 問題 |
|---|---------|------|------|
## Warning（推奨修正）
| # | カテゴリ | 場所 | 問題 | 改善案 |
|---|---------|------|------|--------|
## Info（改善提案）
| # | カテゴリ | 場所 | 提案 |
|---|---------|------|------|
## ビルトイン活用の提案
{カスタムファセットのビルトイン置き換え提案}