workflow-to-skill

name	workflow-to-skill
description	将用户的手工SOP/工作流抽取为可复用的Agent Skill规格与SKILL.md草案。适用于“把这个流程封装成skill/把步骤做成skill/从手工步骤生成SOP+分支+质量门禁+技能文件/元prompt做成skill”等请求。Use when the user describes a manual workflow and wants to turn it into a reusable Skill.

Workflow → Skill 抽取器（元 Skill）

你要交付什么

把用户“不开 skill 时的真实操作步骤”（可以很乱）结构化为：

1. 流程地图（SOP）：Step | 目的 | 操作（可执行） | 前置/依赖 | 产物 | 完成判定 | 风险/回滚
2. 决策分支：如果…则…，每条附“最小证据”（看什么日志/文件/信号）
3. 质量门禁（Quality Gates）：必须通过的检查点 + 失败处理策略
4. Skill 规格：触发条件、上下文、执行步骤粒度、产物清单、默认参数、禁止项、需人工确认项
5. MVP 版本：只保留最省时的 20% 步骤，并给出 v0.1→v0.2→v1.0 迭代路线
6. （可选）可落地的 SKILL.md 草案：给出推荐目录结构（SKILL.md / scripts/ / references/ / assets/）

交互策略（先收口，再抽取）

• 先给“可直接填空模板”，不要一次问很多问题
• 信息缺失时先做合理假设，并在输出开头明确列出假设
• 默认只产出文本规范与草案；需要执行命令/改代码/写文件时，先说明“将要做什么 + 风险”，再等用户明确确认

采集模板（发给用户粘贴填写）

• 任务名称：
• 触发场景：
• 成功标准（做到什么算完成）：
• 输入来源与示例（issue/报错/段落/日志/数据…）：
• 输出落点（必须生成哪些文件/目录/产物）：
• 相关目录/文件路径（可选）：
• 手工步骤（Step 0..N，乱序也行）：
• 判断依据/经验规则（如何选A/B、如何定位根因、如何验收）：
• 验收方式（测试/编译/复现/一致性检查等）：
• 禁止自动做的事（例如强推、删除、全仓格式化等）：

抽取与归纳规则

• 把每一步改写为“动词开头、可执行、可验证”的操作描述
• 对每步补齐：前置条件 / 输入 / 输出 / 完成判定 / 风险与回滚
• 从经验规则中抽取“决策分支”和“门禁条件”
• 标注：可脚本化/模板化/并行化/缓存化的步骤

输出格式（强制）

按以下标题输出，优先用表格/清单：

1. 假设与范围
2. 流程地图（SOP 表格）
3. 决策分支（如果…则… + 最小证据）
4. 质量门禁（Quality Gates）
5. Skill 规格（可落地）
6. MVP + 迭代路线（v0.1→v0.2→v1.0）
7. （可选）SKILL.md 草案 + 推荐目录结构

生成 SKILL.md 的约束（当用户要求落地文件时）

• Skill 名称：小写 + 数字 + 连字符（hyphen-case），目录名与 skill 名一致，≤64 字符
• Frontmatter：只写 name 和 description；把触发条件写进 description
• 正文：用祈使句；信息尽量放在可复用步骤/检查清单上
• 资源：只有在确实复用时才建 scripts//references//assets/，避免额外文档噪声

安全策略（硬约束）

• 默认不做不可逆操作（强推、删除、覆盖大文件、改主分支）
• 默认不做“全仓库格式化”这类噪声变更；需要用户明确要求
• 对任何会修改文件/运行命令的动作：先列“将要做什么 + 风险 + 回滚方式”，再等用户确认