Flow2Spec: Skill for Claude Code

执行口径：本技能代用户执行 git 操作；不使用 git add -A / git add .，不跳过 hooks（--no-verify），不自动 push。git pull / git fetch 合并入本地前必须取得用户对「拉取」的明确确认；git commit 不要求单独一轮「确认」交互（见步骤 3–4）。用户明确要求“快捷提交”时，仅跳过步骤 2 知识库覆盖检查，其余安全步骤照常执行。

编排（主 / 子 agent）

• subAgent / switchAgentVerification 语义以统一入口为唯一事实源：Cursor/Claude 读配置根 rules/f2s-flow2spec-unified-entry.*；Codex 读 .codex/topics/f2s-flow2spec-unified-entry.md。
• 本技能全程在主 agent 完成（pull 的确认不可下放子 agent；git commit 不要求单独一轮用户确认，见步骤 3–4）。

f2s-git-commit（提交代码）

强制流程

快捷提交模式

当用户本轮明确说出 “快捷提交”、“快速提交” 或 “quick commit” 时，进入快捷提交模式：

• 跳过 步骤 2：知识库覆盖检查，不读取 .Knowledge/topics/ / .Knowledge/stock-docs/ 做覆盖判断。
• 不提示用户先运行 f2s-kb-sync / f2s-kb-feat。
• 不跳过步骤 1 的变更读取与冲突标记检查。
• 不跳过步骤 3 的提交信息生成与展示。
• 不跳过步骤 4 的精确 git add <文件列表>、正常 git commit 与 git hooks。
• 不得因快捷提交使用 git add -A / git add . / --no-verify / 自动 push。

步骤 1：读取变更（只读）

git status --short
git diff HEAD

• 从 git status --short 区分三类文件：
  • Staged：已 git add，前缀为 M 、A 、D （首列非空）
  • Unstaged：已追踪但未 add，前缀为 M、 D（次列非空）
  • Untracked：?? 前缀，新文件尚未追踪
• 若三类均为空（nothing to commit），直接告知用户并结束。

冲突检查（必须，先于一切）：

扫描所有变更文件内容，若任意文件包含 <<<<<<<、=======、>>>>>>> 冲突标记，立即终止并提示：

❌ 检测到未解决的 merge conflict：
  - <文件路径>

请先解决冲突后再提交。

步骤 2：知识库覆盖检查（默认必须；三种情况可跳过）

若处于快捷提交模式，本步骤直接跳过，并在步骤 5 收尾提示中说明“已按快捷提交跳过知识库覆盖检查”。

先判断 .Knowledge/ 是否存在：

• 若 .Knowledge/manifest-routing.json 不存在：跳过本步骤，在步骤 5 收尾提示「项目尚未初始化 Flow2Spec 知识库，建议运行 flow2spec init」，继续步骤 3。

跳过判定 A：改动纯文档 / 知识库自身（进入覆盖检查前先判定）

若步骤 1 收集到的 pending 文件路径全部命中以下模式,直接跳过本步骤（在步骤 5 说明「本次改动纯文档,已跳过覆盖检查」）：

• .Knowledge/**（改的就是知识库自己,检自己无意义）
• docs/** / docs/en/**
• README*.md / LICENSE / CHANGELOG*
• .claude/** / .cursor/** / .codex/**（agent 配置根,由 flow2spec init 分发,与业务能力覆盖无关）
• presentations/** / assets/** / 其他纯静态资源

任一文件落在 src/ / lib/ / cli.js / templates/ / 业务代码目录时,本捷径不生效,继续走覆盖检查。

跳过判定 B：近期已同步过知识库