skill-recommender

skill-recommender

目的

リクエストに適した aidoc-flow のスキルを推薦し、ユーザーがすべてのカタログを把握していなくても済むようにします。意図を解析し、スキルセットに照らし合わせて、信頼度と根拠を添えた優先順位付きの推奨を返します。

レイヤー：横断的なユーティリティ（成果物の生成や利用はありません）。

使用するタイミング

次の場合に使用します：

• ドキュメント作成タスクにどのスキルが適しているか、ユーザーが判断できない場合。
• ワークフローを開始し、次のステップについて案内が必要な場合。
• ある意図をどのスキルがカバーするかを確認する場合。

次の場合は使用しないでください：

• ユーザーが特定のスキルを指定している場合（そのスキルを直接実行します）。
• タスクがドキュメント作成以外の作業である場合。

ワークフロー全体のルーティングについては、../doc-flow/SKILL.md を参照してください。

動作

ステップ 1 — 意図を解析する

リクエストからアクションと対象を抽出します。

アクション	シグナルとなるキーワード
作成	create、write、draft、new、add
更新	update、modify、edit、revise
検証	validate、check、verify、audit、review
分析	analyze、examine、inspect
計画	plan、roadmap、schedule、organize

対象	キーワード	対応先
ビジネス要件	business、brd、objectives	doc-brd
プロダクト要件	product、prd、features、user stories	doc-prd
正式な要件	ears、when-the-shall	doc-ears
テストシナリオ	bdd、gherkin、scenarios	doc-bdd
アーキテクチャ上の決定	adr、decision	doc-adr
技術仕様	spec、interfaces、data models	doc-spec
テスト定義	tdd、test cases、thresholds	doc-tdd
実装計画	iplan、file manifest、execution	doc-iplan
トレーサビリティ	trace、links	trace-check
ドキュメント間の検証	validate、consistency	doc-validator
図	diagram、chart、flow	charts-flow
ロードマップ	roadmap、adr implementation	adr-roadmap
命名／ID	id、naming、format	doc-naming
新規プロジェクト	initialize、scaffold、greenfield	project-init
既存のコードベース	adopt、brownfield、existing code、reverse-engineer	project-adopt
プロジェクトに合わせてフローを調整する	adapt、profile、house style、skip layer、stricter gate、glossary	project-profile
ローカルでの調整を昇格させる	promote、extract、generalize、upstream、contribute back	knowledge-extractor
公開済み成果物への変更	change、chg、modify existing、change request	doc-chg
承認ゲート	gate、approval、sign-off	gate-check

ステップ 2 — カタログと照合する（54 個のスキル）

レイヤーファミリー — それぞれ 4 つのバリアントがあります。base、-autopilot（エンドツーエンドで生成）、-audit（品質ゲート）、-fixer（監査で検出した問題を修正）です。

doc-brd · doc-prd · doc-ears · doc-bdd · doc-adr · doc-spec · doc-tdd · doc-iplan（× {base, -autopilot, -audit, -fixer} = 32 個のスキル）。

変更管理ファミリー — 既存の成果物を編集するための CHG オーバーレイ（レイヤーではなく、ガバナンスオーバーレイ）で、同じ 4 つのバリアントがあります。

doc-chg（× {base, -autopilot, -audit, -fixer} = 4 個のスキル）。

ユーティリティ（18 個）：

スキル	カテゴリ	役割
doc-flow	core-workflow	ワークフローオーケストレーター／ルーティング
project-init	core-workflow	新規プロジェクトのスキャフォールドを作成する（グリーンフィールド）
project-adopt	utility	既存のコードベースに SDD を導入する（ブラウンフィールド）
project-profile	utility	プロジェクト適応プロファイル（.aidoc/profile.yaml）を作成・維持する
knowledge-extractor	utility	プロファイルと学習内容から昇格提案の草案を作成する
gate-check	utility	CHG 承認ゲートを実行し、承認を準備する
doc-naming	utility	ID と命名の管理
doc-ref	utility	参照（REF）ドキュメント
doc-review	utility	複数領域にまたがる品質レビュー
doc-validator	utility	ドキュメント間の検証
trace-check	utility	双方向のトレーサビリティ
charts-flow	utility	Mermaid ダイアグラム
adr-roadmap	utility	ADR からロードマップを作成する
context-analyzer	utility	プロジェクトコンテキストの分析
quality-advisor	utility	品質に関するアドバイス
skill-recommender	utility	このスキル
workflow-optimizer	utility	ワークフローの最適化
security-audit	utility	セキュリティ分析

ステップ 3 — スコアを付けて順位付けする

意図との一致（40％）、対象との一致（30％）、コンテキストへの適合度（20％）、一般的なシーケンス（10％）に重みを付けます。信頼度を分類します。高 ≥80％、中 50～79％、低 <50％（明確化を提案）。

ステップ 4 — 推薦する

順位付けしたエントリーを最大 3 件返します。各エントリーには skill、confidence、rationale、および next_steps または condition を含めます。意図が曖昧な場合は、推測するのではなく、確認の質問を 1 つ尋ねます。

recommendations:
  - skill: doc-prd
    confidence: 92%
    rationale: "Request mentions 'product requirements' — direct PRD match."
    next_steps: "Run doc-prd to create the PRD."
  - skill: doc-brd
    confidence: 55%
    rationale: "A BRD may be needed upstream if none exists."
    condition: "Use if no BRD covers this feature."
clarification_needed: false

関連リソース

• ワークフローのルーティング：../doc-flow/SKILL.md
• プロジェクトコンテキストの入力：../context-analyzer/SKILL.md
• ワークフロー上の位置の把握：../workflow-optimizer/SKILL.md
• レイヤーレジストリ：framework/registry/LAYER_REGISTRY.yaml