# Workflow To Skill

> 将用户的手工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. Use when this capability is needed.

- Skill: `tomevault-io/workflow-to-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/workflow-to-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/workflow-to-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/workflow-to-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/`，避免额外文档噪声

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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/phmbench) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->