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 个技能）

分层系列 — 每个分层都提供四种变体：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	搭建新项目（绿地项目）
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。当意图模糊不清时，应提出一个澄清问题，而不是猜测。

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