skill-plan 是 skill-wizard 动态访谈所使用的领域知识，用于创建或完善 .skill-plan.yaml 文件。它提供模式分支、术语映射和规划反模式，帮助在访谈中确定意图、范围、机制、层级、目标路径等关键字段。
用途
该知识库用于指导 skill-wizard 的访谈流程，通过模式匹配规则，根据用户上一个回答选择下一个问题。匹配规则为从上到下，首次命中即生效。若无模式匹配，则针对覆盖最少的模式字段请求澄清。全局规则要求：呈现选项时，列出所有有效选择并赋予同等权重，绝不预选、缩小范围或以“这看起来像 X——同意吗？”结尾，让用户自行选择。例外情况：skill-wizard 中的 State 0.5 在信号明确时可能呈现推荐深度，但用户覆盖必须保持显式。
主要能力
该知识库包含多个分支，用于处理不同访谈场景：
- 分支 1：意图澄清。触发条件：意图模糊、多用途或包含超过 2 个不同动词。信号词包括“and also”、“plus”、“everything”、“all-in-one”。操作：要求用户选择最重要的单一能力，其他成为 workflow_notes。解决字段：intent。
- 分支 2：范围探测。触发条件：意图清晰但范围模糊，用户未说明 single/moderate/extended。信号词包括“a few steps”、“simple”、“complex”、“orchestrate”、“pipeline”。操作：呈现范围选项及具体示例：Single（一个动作，一个输出，例如格式化文件）、Moderate（2-5 个协调步骤，例如 lint → fix → report）、Extended（多阶段编排，例如 plan → execute → verify → rollback）。解决字段：scope、tier（派生：single→A，moderate→B，extended→C）。
- 分支 3：机制检测。触发条件：范围已解决，用户提及代码、正则、解析、确定性逻辑或 AI 判断。信号词包括“script”、“regex”、“parse”、“deterministic”、“AI”、“reasoning”、“LLM”、“judgment”。操作：若信号明确指向一种机制，则确认；若模糊，则呈现选项：Reasoning（AI 读取输入，应用判断，产生输出）、Scripts（确定性代码处理逻辑，如正则、解析器、格式化器）、Hybrid（AI 编排，脚本处理繁重工作）。解决字段：mechanism。
- 分支 4：上下文资产发现。触发条件：机制已解决，工作流暗示外部数据、模式或参考材料。信号词包括“spec”、“schema”、“template”、“checklist”、“config”、“manifest”、“reference doc”。操作：询问技能需要哪些静态资产，提供类别：none（技能自包含）、schema（用于验证的 JSON/YAML 模式）、templates（文档或提示模板）、checklists（验证列表）、manuals（要参考的外部文档）。解决字段：context_assets。
- 分支 5：流水线分解。触发条件：范围为 moderate 或 extended，步骤尚未枚举。信号词包括“steps”、“stages”、“phases”、“first...then”、“workflow”。操作：要求用户按顺序列出具体步骤，每个步骤 = 一个动词 + 一个输出。解决字段：workflow_notes（部分——步骤作为笔记捕获）。
- 分支 6：多角色检测。触发条件：回答提及不同参与者、权限或受众。信号词包括“admin”、“user”、“reviewer”、“approver”、“CI”、“human-in-the-loop”。操作：询问哪些角色与技能交互以及如何交互。若技能需要角色条件逻辑（→ 可能推动脚本），则标记。解决字段：workflow_notes（追加角色笔记），若角色暗示脚本，可能重新打开机制。
- 分支 7：混合边界。触发条件：机制为 hybrid，推理与脚本之间的划分不清晰。信号词包括“AI decides”、“script handles”、“conditional”、“fallback”。操作：询问“哪些步骤需要确定性代码，哪些需要 AI 判断？”将每个工作流步骤映射到 reasoning 或 script。解决字段：workflow_notes（追加边界映射）。
- 分支 8：目标路径解析。触发条件：所有内容字段已解决，位置尚未设置。信号词包括“save”、“where”、“path”、“directory”。操作：询问保存位置。若用户不确定，建议工作区根目录下的 skills/<skill-name>/。若路径冲突则警告。解决字段：target_path。
- 分支 9：示例策略。触发条件：层级已确定，示例放置未决定。操作：基于层级：Tier A → 默认内联（## Example in SKILL.md），确认或覆盖；Tier B/C → 默认 references/Example.md，确认或覆盖。解决字段：example_placed、example_generated。
- 分支 10：工作流细化。触发条件：所有 9 个基本字段均有值，unanswered_branches 非空。操作：处理每个剩余分支，每轮每个分支问 1 个问题。当分支解决时，从 unanswered_branches 中移除。解决字段：清除 unanswered_branches → 触发停止条件。
规划反模式
在访谈期间标记以下反模式，不允许它们进入 .skill-plan.yaml：
- 大杂烩意图：意图有超过 3 个不同动词或“and also”链。修复：拆分，选择主要意图，其他 → workflow_notes 或单独技能。
- 范围蔓延：用户在范围锁定后添加主要能力。修复：询问“新技能还是添加到 workflow_notes？”若为新技能 → 建议单独计划。
- 机制反复：用户改变机制超过 2 次。修复：暂停，总结权衡，要求最终承诺。
- 幻影脚本：用户命名脚本但无法描述其功能。修复：探查“X.sh 接受什么输入？输出什么？”无答案 → 丢弃。
- 模糊目标路径：用户说“某处”或“随便哪里”。修复：建议具体默认值，要求显式确认。
- 过度分解：用户为 moderate 范围列出超过 10 个工作流步骤。修复：建议合并相关步骤。若确实超过 10 → 重新评估范围（moderate → extended）。
- 角色爆炸：用户描述超过 4 个不同角色。修复：询问哪些对 v1 是必要的，其他推迟到未来迭代。
模式验证规则
在审查门（State 2）之前，验证：
- intent 不超过 2 句话，包含至少 1 个具体动词。
- scope 恰好为：single、moderate、extended 之一。
- mechanism 恰好为：reasoning、scripts、hybrid 之一。
- context_assets 恰好为：none、schema、templates、checklists、manuals 之一。
- tier 与 scope 匹配（single→A，moderate→B，extended→C）。
- target_path 非空，不含空格，以 / 结尾。
- 若 scope 为 moderate 或 extended，workflow_notes 至少有 1 个条目。
- example_placed 恰好为：inline、references/Example.md 之一。
- example_generated 为布尔值。
若任何验证失败 → 在审查门中向用户标记，要求批准前修复。
参考文件
- Terminology — agentskills.io 术语映射和字段定义。
- Pattern Index — 边缘情况触发器和罕见分支条件。
适用场景
该知识库适用于使用 skill-wizard 创建或完善 .skill-plan.yaml 的场景，特别是在解析范围、机制、层级、目标路径选择，或为后续步骤准备计划输入时。
限制
该知识库的具体实现细节、与 skill-wizard 的集成方式、以及参考文件的具体内容暂未提供。