skill-recommender

用途

skill-recommender 用于为某个请求推荐合适的 aidoc-flow 技能，使用户无需了解完整技能目录。它会解析用户意图，与技能集合匹配，并返回带置信度和理由的排序推荐。该技能属于跨领域工具层，不产生也不消费任何产物。

主要能力

意图解析：从请求中提取“动作”和“目标”。

动作及其信号关键词：

create（create、write、draft、new、add）
update（update、modify、edit、revise）
validate（validate、check、verify、audit、review）
analyze（analyze、examine、inspect）
plan（plan、roadmap、schedule、organize）

目标关键词与对应技能：

business requirements / business、brd、objectives → doc-brd
product requirements / product、prd、features、user stories → doc-prd
formal requirements / ears、when-the-shall → doc-ears
test scenarios / bdd、gherkin、scenarios → doc-bdd
architecture decisions / adr、decision → doc-adr
technical specification / spec、interfaces、data models → doc-spec
test definitions / tdd、test cases、thresholds → doc-tdd
implementation plan / iplan、file manifest、execution → doc-iplan
traceability / trace、links → trace-check
cross-document validation / validate、consistency → doc-validator
diagrams / diagram、chart、flow → charts-flow
roadmap / roadmap、adr implementation → adr-roadmap
naming / IDs / id、naming、format → doc-naming
new project / initialize、scaffold、greenfield → project-init
existing codebase / adopt、brownfield、existing code、reverse-engineer → project-adopt
tailor the flow to a project / adapt、profile、house style、skip layer、stricter gate、glossary → project-profile
promote a local adaptation / promote、extract、generalize、upstream、contribute back → knowledge-extractor
change to a published artifact / change、chg、modify existing、change request → doc-chg
approval gate / gate、approval、sign-off → gate-check

目录匹配（54 个技能）：

层级族——每个族提供四种变体：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 覆盖层（治理覆盖层，非层级），具有相同四种变体：

doc-chg（× {base, -autopilot, -audit, -fixer} = 4 个技能）。

工具（18 个）：

doc-flow：core-workflow，工作流编排/路由
project-init：core-workflow，脚手架新建项目（greenfield）
project-adopt：utility，将 SDD 采纳到已有代码库（brownfield）
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，安全分析

评分与排序：对意图匹配（40%）、目标匹配（30%）、上下文契合（20%）和常见序列（10%）加权。置信度分级：高 ≥80%，中 50–79%，低 <50%（建议澄清）。

推荐输出：返回最多 3 条排序条目，每条包含 skill、confidence、rationale，以及 next_steps 或 condition。当意图不明确时，改为提出一个澄清问题，而不是猜测。

示例输出（YAML）：

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。

适用场景

适用于 aidoc-flow 框架内的文档相关工作流中，帮助用户从 54 个技能中定位合适的技能，尤其在用户刚开始工作流、对可用技能不熟悉或不确定下一步时。

限制

该技能属于跨领域工具，本身不生成或消费产物。
当意图模糊时，不会进行猜测，而是提出澄清问题。
完整的工作流路由不由本技能负责，需交给 ../doc-flow/SKILL.md。

技能介绍

用途

主要能力

使用方式

适用场景

限制

相关资源