summersec Workflow Skill Creator
核心角色
将多步骤、有状态、需跨步骤传递数据的复杂任务转化为结构化的流程编排 Skill。
适用场景
以下信号使用本 skill（≥3 个即适用）：
- 任务需要 ≥3 个顺序步骤，步骤间有依赖关系
- 步骤间需传递和累积状态数据（中间分析结果）
- 需要确定性脚本辅助重复操作（路径生成、数据匹配、格式转换）
- 有明确判定规则和领域知识需引用
- 输出需标准化格式（报告模板、JSON 结构）
- 需强制执行顺序，跳步导致分析不完整
不适用场景 — 使用普通 skill-creator：
- 单步操作（格式转换、代码生成）
- 无状态传递的简单指导
- 纯知识检索
六大架构模式
详细原理与反模式见 架构模式参考。
| 模式 | 核心思想 | 解决的问题 |
|---|---|---|
| 1. 进度文件驱动 | 一个 Markdown 文件贯穿全流程，追加不覆盖 | 跨步骤状态丢失 |
| 2. 步骤框架分离 | SKILL.md <200行，每步详细框架独立文件 | SKILL.md 膨胀 |
| 3. 三阶段执行 | 每步：前置校验 → 执行记录 → 后置校验 | 跳步、结果不验证 |
| 4. 脚本自动化 | 确定性任务提取为独立脚本 | 输出不一致 |
| 5. 资源分层 | 元数据→主体→框架→参考 四级加载 | 上下文浪费 |
| 6. 路径一致性 | {progress_file_path} 占位符全程传递 |
路径断裂 |
创建流程（6 步）
详细操作指南见 创建流程详细指南。
Step A: 需求梳理与步骤分解
先收集具体示例（用户原句写法、典型场景、期望输出），再确认任务画像（输入/输出/步骤数）。将任务分解为 3-8 个有明确依赖关系的顺序步骤，识别需跨步骤传递的状态数据。
Step B: 目录结构设计
使用脚手架脚本一键生成标准目录：
python3 ~/.claude/skills/workflow-skill-creator/scripts/scaffold_workflow_skill.py \
--name {skill-name} \
--steps {n} \
--step-names "步骤1,步骤2,..." \
--output ~/.claude/skills/{skill-name}/
脚本生成：SKILL.md 骨架、步骤框架文件、路径生成脚本、进度文件规范、模板文件。生成后逐文件填写具体内容。
Step C: 撰写 SKILL.md
遵循 Skill 模板，保持主体 <200 行。核心区块：角色 → 场景 → 架构模式 → 步骤概要 → 资源索引。用祈使语气，解释"为什么"而非仅仅"必须"。
Step D: 撰写步骤框架文件
每个 references/step_frameworks/stepN_xxx.md 遵循 Step 框架模板。必须包含：校验规则（前置+后置 checklist）、核心执行流程（可复制执行的命令）、完成标准与验收。开头必须有 ⚠️ 路径一致性要求 警告块。
Step E: 撰写脚本和模板
必建：路径生成脚本 — 根据输入参数生成确定性进度文件路径。可选：数据匹配脚本、格式转换脚本、校验脚本。模板：进度文件结构模板 + 最终输出模板。
Step F: 迭代优化
创建完成后，用真实场景测试 skill，根据执行表现调整步骤粒度、校验规则和模板。详细方法见 创建流程详细指南 Step F。
参考资源
方法论文档
- 架构模式详细说明 — 六大模式的原理、实现方式和反模式。创建前通读，设计时对照参考。
- 创建流程详细指南 — 五步流程的完整操作细节。执行 Step A-E 时按需读取对应章节。
- 进度文件规范模板 — 可复用的进度文件规范。Step B 后定制为目标 skill 的规范。
- 质量检查清单 — 交付前逐项自检。Step E 完成后使用。
模板
- Skill 模板 — SKILL.md 文件骨架，Step C 时参考
- Step 框架模板 — 单步骤框架文件模板，Step D 时参考
- 进度文件模板 — 进度文件结构模板，Step E 时参考
脚本
scripts/scaffold_workflow_skill.py— Step B 使用。--name--steps--step-names--output四个参数，生成完整目录结构。--help查看用法。