Flow2Spec: Skill for Claude Code

执行口径：技术方案文档统一落在 .Knowledge/req-docs/；规则能力仍由配置根 rules/skills 加载。

编排（主 / 子 agent）

• 两字段（subAgent / switchAgentVerification）语义以统一入口为唯一事实源：Cursor/Claude 读配置根 rules/f2s-flow2spec-unified-entry.*；Codex 读 .codex/topics/f2s-flow2spec-unified-entry.md（与上同源，flow2spec init 镜像）。本文不复述。
• 默认不拆子：追问-落盘必须在主 agent 内完成（子 agent 无法向用户追问）。
• 可选拆子：仅当 subAgent=true 且 PDF 规模超阈值（> 50 页 或 > ~5MB 文本）时启用；子 agent 仅负责 PDF→MD 首稿并落盘 .Knowledge/req-docs/<名>.md，不向用户追问、不写「流程说明」章节；主 agent 接手后续追问与流程图补写。
• 校验默认由落盘侧 agent 自验；本 SKILL 不绑定交叉校验。

将 PDF 技术方案文档转为 Markdown（并补全流程说明）

用户会在本技能后附带一个参数：PDF 技术方案文档的本地路径（如 ~/Downloads/技术方案.pdf，或 .Knowledge/req-docs/某草稿.pdf）。请按以下步骤执行，将 PDF 转为 Markdown 并保存到 .Knowledge/req-docs/，必要时引导用户补全流程说明。

步骤 1：读取 PDF 并转为 Markdown

1. 若启用拆子（PDF > 50 页 或 > ~5MB），子 agent 仅负责 PDF→MD 首稿并落盘 req-docs/<名>.md，不追问、不写流程说明；主 agent 接手后续步骤。读取用户传入的 PDF 文件，提取其中的文字内容（表格、章节、列表、代码块等尽量保留结构），整理为 Markdown 格式。
2. 保存到 .Knowledge/req-docs/，推荐路径：.Knowledge/req-docs/<方案名>.md。文件名为原 PDF 文件名去掉 .pdf 后加 .md。
3. 若目录不存在，先创建再写入。
4. 保存后告知用户：「已将该 PDF 转为 Markdown 并保存为 xxx.md。」

---

步骤 2：向用户提问获取流程图（可选但推荐）

PDF 内嵌的流程图无法被直接解析为步骤与分支，若需按图实现代码，需用户配合提供。

1. 向用户说明：「文档中可能包含流程图，我无法从 PDF 中解析图中的步骤与分支。若您后续会根据技术方案实现代码（见 implement-tech-design 规则），建议补全流程说明：

• 方式一：将相关流程图以图片形式发到本次对话中，我将解析后以文字形式写入上述 MD；
• 方式二：直接以文字描述每个接口/流程的步骤（如：1. 是否登录 2. 查某表 3. 判断某字段 → 返回结果），我将原样写入上述 MD。
  若文档无流程图或暂不提供，可回复「跳过」，我将结束本技能。」

1. 若用户回复「跳过」或明确表示无需流程说明：告知用户「在对话中提供上述 MD 路径并说明按技术方案实现代码，我将按 implement-tech-design 规则执行。」并结束。
2. 若用户提供流程图（图片或文字）：进入步骤 3。

---

步骤 3：将流程说明写入该 MD

1. 若用户提供的是图片：解析图片中的步骤、判断分支与返回，整理为文字步骤。
2. 若用户提供的是文字：直接采用。
3. 在该 MD 文件末尾（或新增「流程说明」章节）追加流程内容，格式示例：

## 流程说明（由用户提供 / 由流程图解析）

### 示例接口 A
1. 前端发起请求
2. 后端：查询某表最后一条记录
3. 判断：是否有某 ID？是 → 返回 true，否 → 返回 false
4. 返回结果

### 示例接口 B
1. 是否登录 → 否 返回 401
2. 是否过期 → 是 返回 403
…

1. 保存后告知用户：「流程说明已写入 xxx.md。接下来请在对话中提供该 MD 路径并说明要按技术方案实现代码，我将按 implement-tech-design 规则执行。」