📄 本页由源文件
skills/dev-flow/flowchart/versions/v3_2026-07-06/flowchart.md自动投影生成（单一权威源）。请勿直接编辑本页。
流程图 v3 2026-07-06
静态 Mermaid 版本，可在 GitHub / IDE 中直接渲染预览。 交互式版本（支持点击跳转到源文件）：flowchart.html
v2 → v3 核心变更（2026-07-06）
程序化执行层重构：v3 将大量门控规则从提示词下沉为脚本，以物理文件事实替代 AI 记忆信任。 核心变更点：
- 触发机制改版：v2 的关键词自动触发（说"修复"就进）→ v3 的仅显式命令触发（
dev-flow/dev:/--micro等），避免误触发- 模式矩阵扩展：v2 的 4 模式（完整/快速/极速/收尾）→ v3 的 6 种基础模式（standard/full/micro-fix/iteration-fix/batch/cross-project）+ 1 种修饰层（streamlined 精简交互）
- micro-fix 轻量模式：新增单文件 ≤10 行快速修复模式，含三道防线自动降级机制
- 物理检查点系统：每个步骤完成后由脚本原子创建
.step-{N}.validated文件，AI 不可伪造- 程序化执行层：状态机（
state-machine.sh）、Hooks（pre-step.sh/post-step.sh）、8 套 Lint 脚本、工具门禁- 编码前置硬卡点：步骤 5 前强制执行 4 项校验（
step5-precheck.sh），禁止绕过- 新增命令：
dev:sync（流程内文档同步）、dev:onboard（profile 生成）、dev:kb（知识库管理）- 移除命令：
dev:specs已移除，规范管理归入 knowledge-loop- 重命名：
wrapup-flow.md→closeout-flow.md- 分批执行：大型需求可按模块拆分为多批次，每批 4.5→5→5.5→6→7 循环
- 需求漂移子流程：开发中需求变更的结构化处理（
drift-handling.md）- 阶段 0.5：项目画像轻量注入（仅本地 profile 存在时，0 MCP 调用）
- 跨项目预检：显式命令入口堵漏，防止多项目切换时遗忘未完成的工作上下文
- 交互式选项一致性：C1-C8 lint 确保文本表格与
ask_followup_question严格对应
1. 入口触发与模式路由
设计理念（v3 改版）：v2 中用户说"修复/优化"等关键词会自动触发 dev-flow，造成误触发和意外打断。 v3 改为仅显式命令触发：用户必须明确输入
dev-flow/dev:/--micro等命令才会进入流程。 AI 检测到开发意图关键词时只在回复中建议使用 dev-flow，不自动触发。
命令速查（v3 当前有效命令）：
| 命令 | 快捷 | 说明 |
|---|---|---|
dev-flow / dev: / /dev-flow | — | 进入统一流程 |
dev:sync | dev:s2 | 流程内全量文档同步（不生成 commit，完成后回原步骤） |
dev:status | dev:st | 工作上下文进度概览 |
dev:kb | dev:k | 知识库管理 |
dev:metrics | dev:m | 度量查看（支持 --all/--trend/--dashboard） |
dev:onboard | dev:ob | 知识库平台 profile 生成/刷新 |
--fast | — | 精简交互修饰层（可与任意命令组合） |
--micro | — | 显式启动 micro-fix 模式（单文件 ≤10 行快速修复） |
v3 触发原则：dev-flow 仅由显式命令触发（
dev-flow/dev:/--micro等）或活跃流程相关恢复触发。 AI 不得基于关键词主观判断自动触发。开发意图关键词（修复/优化/新需求/任务平台/Figma）时，AI 在回复中建议使用dev-flow命令。 活跃流程恢复：未匹配显式命令时，自动检查.active-flows/目录。单条匹配+消息相关 → 自动恢复；多条或无关 → 展示清单。 跨项目预检：显式命令入口强制检查是否有其他项目的未完成工作上下文，防止遗漏。
2. 统一流程总览（阶段 0 + 0.5 + 步骤 1~10）
v3 延续 v2 的单一流程设计：所有需求走同一条流程，执行深度不在入口决定，在步骤 4 由 AI 基于步骤 1~3 研究成果智能评估推荐。 v3 新增阶段 0.5（项目画像轻量注入）和分批执行、跨项目等模式扩展。
流程总览表（步骤名称以 step-router.md 为准）：
| 步骤 | 名称 | 加载文件 | 核心产出 | 执行深度 |
|---|---|---|---|---|
| 0 | 需求理解 | use_skill("requirement-intake") | 需求确认 + 分支告知收集（仅 user_specified） | 全部 |
| 0.5 | 项目画像轻量注入 | 本地 _profile.md（0 MCP） | project_profile 或 skipped | 本地 profile 存在时 |
| 1 | 研究与定位 | steps/step-1-research.md | 相关文件表格 | 全部 |
| 2 | 确认范围 | steps/step-2-scope.md | 影响范围报告 + 用户确认 | 全部 |
| 3 | 制定方案 | steps/step-3-plan.md | 执行计划表格 | 全部 |
| 4 | 方案汇报与用户决策 | steps/step-4-decision.md | 评估卡片+执行深度选择+分支定稿+文档决策 | 全部 |
| 4.5 | 环境检查 | steps/step-4.5-env-check.md | 分支确认（主干拦截） | 全部 |
| 5 | 执行修改 | steps/step-5-execute.md | 代码改动 | 全部 |
| 5.5 | 编码后置钩子 | steps/step-5.5-post-coding.md | L1审查+文档同步+ESLint自检 | 全部 |
| 6 | 质量验证 | steps/step-6-verify.md | 验证报告（6A/6B/6C） | 全部 |
| 7 | 清理+Commit | steps/step-7-commit.md | L2审查+commit+devlog+knowledge（标准）或 L2审查（完整裁剪） | 全部 |
| 8 | L3 代码审查 | steps/step-8-10-full.md | L3多视角深度审查 | 仅完整执行 |
| 9 | 反思与学习 | steps/step-8-10-full.md | 度量报告+经验提炼 | 仅完整执行 |
| 10 | 归档与交付 | steps/step-8-10-full.md | commit+devlog+knowledge+交付报告 | 仅完整执行 |
★ = 仅完整执行时执行的步骤。步骤 0~7 为所有需求共享。 标准执行（步骤 5→7）：步骤 7 执行全部环节 A~K（清理+L2审查+Commit+Devlog+Knowledge+度量+经验快检+dev-logs自检），流程结束。 完整执行（步骤 5→10）：步骤 7 仅执行 A~G（清理+L2审查），Commit/Devlog/Knowledge 推迟到步骤 10。 分批执行（步骤 4.5→7 循环）：每批独立走 4.5→5→5.5→6→7，最后一批完整收尾。 执行深度由步骤 4 基于步骤 1~3 研究成果智能评估推荐，用户可自由覆盖。
3. 模式矩阵（6 种基础模式 + 1 种修饰层）
v3 核心设计：基础模式和交互修饰层是两个独立维度，可正交组合。 基础模式描述流程的步骤覆盖与编排策略（互斥单选），修饰层仅调节交互频率（可与任意基础模式叠加）。
基础模式全景矩阵
| 模式 | 触发条件 | 阶段0 | 0.5 | 1 | 2 | 3 | 4 | 4.5 | 5 | 5.5 | 6 | 7 | 8-10 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| standard | 默认 + 步骤4选 execute_standard | ✅ | 🔹 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅结束 | — |
| full | 步骤4选 execute_full | ✅ | 🔹 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅裁剪 | ✅ |
| micro-fix | --micro 命令 + ≤10行 + 单文件 | ✅精简 | ❌ | ❌ | ❌ | ❌ | ❌ | 🔹主干检测 | ✅ | 🔹L1极简 | ✅lint | ⚡极简收尾 | — |
| iteration-fix | 活跃.flow + 迭代意图（提测反馈等） | 🔹简化 | ❌ | 🔹增量 | 🔹增量 | 🔹增量 | — | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| batch | 步骤4选 execute_batched | ✅ | 🔹 | ✅ | ✅ | ✅ | ✅ | ✅循环 | ✅循环 | ✅循环 | ✅循环 | ✅循环 | 最后批 |
| cross-project | 步骤2检测到 workspace 外修改 | ✅ | 🔹 | ✅ | ✅跨 | ✅跨 | ✅ | ✅ | ✅ | ✅ | ✅跨 | ✅跨 | — |
✅ 执行 / ❌ 跳过 / 🔹 按需触发 / 循环 = 批次循环 / 裁剪 = 步骤7仅A~G
micro-fix 降级条件（三道防线）：改动 >15 行 / ≥2 文件 / 主干分支 → 自动降级到 standard。 L1 极简审查发现 ≥3 个 🔴 → 自动降级。跳过的步骤禁止补做，若需补做必须降级重走。 修饰层 streamlined：用户说"少问我"/
--fast时启用，仅豁免 4 处步骤流转弹窗（0.5→1 / 4.5→5 / 5→5.5 / 5.5→6），关键决策点🔴任何模式不豁免。
4. 步骤 4：方案汇报与用户决策（4 个环节）
v3 增强：步骤 4 是编码前最后一道门控。v3 新增 技术方案文档决策（硬性必走）、dev-logs 目录命名 lint、分支名唯一定稿点。
环节速查：
| 环节 | 执行时机 | 是否必走 | 交互方式 |
|---|---|---|---|
| 环节 1 · 评估输出 | 方案汇报末尾自动 | ✅ 必走 | 输出展示，无弹窗 |
| 环节 2 · 执行深度决策 | 第 1 次弹窗 | ✅ 必走 | ask_followup_question |
| 环节 3 · 文档决策 | 第 2 次弹窗（仅执行类选项进入） | ✅ 硬性必走 | ask_followup_question |
| 环节 4 · 决策落地 | 串行三步：§4.1 分支定稿 → §4.2 plan.md 写盘 → §4.3 文档平台 执行 | ✅ 必走 | 仅 §4.1 特定场景弹窗 |
步骤 4 决策后顺序锚点：环节 4 严格按 §4.1 → §4.2 → §4.3 串行执行。§4.1 分支名定稿发生在 plan.md 写盘前。 文档决策必走：除
user_decision为 modify/change_plan/pause/cancel 外，必须执行 文档平台 空间探测并输出决策。 dev-logs 目录命名：4 项 lint（format_matched / type_valid / brief_has_chinese / no_project_suffix）必须全 true。
5. 步骤 7：收尾流程（closeout-flow.md）— 调用方 × 环节矩阵
v3 变化：v2 的
wrapup-flow.md已于 2026-06-03 重命名为closeout-flow.md。 v3 新增caller=micro-fix-7（轻量保留版）和caller=in-flow-sync（流程内同步子集）。 环节 K（dev-logs 完整性自检）为 v3 新增，通过物理 lint 兜底。
环节清单（A~K，标准执行全部 11 环）：
| 环节 | 内容 | standard-7 | full-7 | micro-fix-7 |
|---|---|---|---|---|
| A | Diff 分析 + 预期外变更处理 | ✅ | ✅ | ✅极简 |
| B | 清理调试代码 | ✅ | ✅ | ✅限改动行 |
| C | 可选链检查 | ✅ | ✅ | ❌ |
| D | 即时验证 | ✅ | ✅ | ❌ |
| E | TODO 检查 | ✅ | ✅ | ❌ |
| F | 改动汇总 | ❌ | ❌ | ❌ |
| G | L2 审查 | ✅ | ✅ 到此结束 | ❌ |
| H | Commit+Devlog+Knowledge | ✅ | ❌ 推迟到步骤10 | ✅极简 |
| I | 数据驱动反思 | ✅ | ❌ | ❌ |
| J | 经验快检（3问） | ✅ | ❌ | ✅静默 |
| K | dev-logs 完整性自检 | ✅ | ❌ 推迟到步骤10 | ❌ |
三种调用方：
caller=standard-7：标准执行步骤 7，执行 A~K 全部 11 环，流程结束caller=full-7：完整执行步骤 7，仅执行 A~G（到 G 结束），H~K 推迟到步骤 10caller=micro-fix-7：极简收尾，A 仅 diff stat + B 限改动行 + H 极简（H.1 commit + H.2 devlog 极简追加 + H.3 knowledge 漂移检测）+ J 静默 + 跳过 C/D/E/G/I/K 环节 H 子步骤：H.1 生成 Commit Message（调用 smart-commit skill）→ H.2 生成/追加开发日志（调用 tech-doc skill）→ H.3 知识沉淀（调用 knowledge-loop skill）→ H.3+ 文档平台 兜底对账（docid 非空时强制执行）
6. 阶段 0：需求理解
核心原则：产出准确性是第一优先级。所有需求（无论大小）都必须经过阶段 0。 阶段 0 通过
use_skill("requirement-intake")加载完整需求理解流程。 v3 变化：分支推荐不再在阶段 0 输出，仅在用户主动告知时记录（branch_status: user_specified），最终推荐在步骤 4 §4.1 唯一定稿。
所有需求（无论大小）都必须经过阶段 0。迭代修复场景下，阶段 0 执行增量理解而非全量理解。 分支推荐唯一定稿在步骤 4 §4.1，阶段 0 只做记录。
7. 阶段 0.5：项目画像轻量注入 + 步骤 1~4.5 子流程
阶段 0.5：项目画像轻量注入
v3 新增：默认沉默跳过。仅本地
_profile.md存在且未过期时将其注入上下文。 0 MCP 调用，< 300 token 开销。绝大部分场景命中skipped_no_profile。
步骤 1：研究与定位
步骤 2：确认范围
步骤 3：制定方案
步骤 4.5：环境检查
v3 增强：主干分支拦截为硬性规则，不可跳过。新增 4 项环境校验。
硬性规则：主干分支下不可进入步骤 5，交互选项中不允许"跳过检查"。 步骤 4.5 推进选项：正常场景（分支一致且非主干）标准模式下仅弹一次推进选项，精简模式一行摘要静默推进。
8. 步骤 5~6 子流程
步骤 5：执行修改
v3 增强：加载前必须通过编码前置硬卡点（
step5-precheck.sh4 项校验）。 按锁定计划执行，禁止计划外改动（红牌 R4）。
编码前置硬卡点 4 项校验：① 工作上下文文件存在 ②
.flow锁文件 current_step ≥ 4.5 ③ 步骤 4 user_decision 非空 ④ 步骤 2/4 交互记录存在。 此卡点不受精简交互模式影响，禁止以"任务简单"为由绕过。
步骤 5.5：编码后置钩子
5.5 不可跳过：每轮编码（含迭代修复）完成后必须执行 5.5a L1 审查 + 5.5b 文档同步 + 5.5c ESLint 自检。 静默累计 ≥3 次未执行 dev:sync → 物理层必弹提醒。
read_lints≠ ESLint，两者都必须执行。
步骤 6：质量验证（6A + 6B + 6C）
7 阶段验证并行策略：V1+V2 并行 → V3+V6 并行 → V4→V5→V7 串行。 3 次失败熔断：同一阶段连续失败 3 次，弹出交互式选项，不再自动重试。 6A 中修复代码后：必须重走 5.5a L1 审查。修复发生在步骤 6→7 之间时，必须重走 5.5→6→7 完整链路（红牌规则，不可跳过）。
9. 完整执行独有步骤（8~10）
以下步骤仅在用户选择「完整执行」时执行。标准执行在步骤 7 结束。
步骤 8：L3 代码审查
步骤 9：反思与学习（数据驱动，4 个子步骤）
跳过条件：全程无回退、无卡顿、无用户纠正，且指标在历史平均 ±30% 范围内时精简输出。 度量数据写入
~/.codebuddy/.metrics/reports/{需求ID}.yaml。
步骤 10：归档与交付
10.6 校验项：① Commit已确认 ② devlog已生成 ③ knowledge已沉淀 ④ 交付报告已输出 ⑤ 规则归档已处理。 10.3.5 文档平台 归档同步前必须通过
doc-platform-doc-lint（6 项文档质量检查），失败则阻断。
10. 特殊流程
迭代修复机制
v3 增强：新增 v3 智能恢复网关（match_keywords 匹配 + 多 .flow 智能排序）、L1 极速恢复（3 句话回忆杀）。 轮次管理：YAML 头部
iteration+iteration_history。
迭代修复场景：步骤 1~3 简化执行（增量研究+增量范围+增量调整），步骤 4~7 无变化。 轮次管理：
iteration >= 3时自动精简早期轮次正文，确保上下文窗口最大化。
分批执行流程
v3 新增：大型需求拆分为多批次，每批独立走 4.5→5→5.5→6→7 循环。
跨项目协作
v3 增强：新增跨项目预检（显式命令入口堵漏）、profile 预检（C3 场景）、单 .flow 架构。
需求漂移子流程
物理检查点与门控系统（v3 核心创新）
设计哲学：用文件系统事实（
.validated物理文件）替代 AI 记忆信任。.validated文件只能由validate-output.sh脚本原子创建，AI 不可自行 touch 伪造（红牌 R5）。
物理检查点白名单（按基础模式分流）：standard 需 step-1~7 全部 / full 需 step-1~10 / micro-fix 仅需 step-4_5~7 / iteration-fix 仅需 step-4_5~7 / batch 同 standard / cross-project 同 standard。 文件命名规则：步骤 4.5 对应
.step-4_5.validated，步骤 5.5 对应.step-5_5.validated（.替换为_）。
工具门禁（红牌 R7）
v3 新增：按步骤限制可调用的工具类别。违规即红牌 #15。
11. 文档同步体系（dev:sync）v3
dev:sync是流程内文档同步入口，任意步骤可召唤，完成后回原步骤。复用closeout-flow.md §H.0~H.3+的文档同步子集。
dev:sync — 流程内同步（caller=in-flow-sync）
- 触发：用户输入
dev:sync/dev:s2，或 AI 主动弹框（场景 A/B） - 前置检查：
.flow必须存在（不存在则提示用户先使用dev-flow进入流程） - 执行：暂存 current_step → 以
caller=in-flow-sync加载 closeout-flow.md → 执行 H.0 CR 同步 + H.2 devlog 增量 + H.3 knowledge 漂移 + H.3+ 文档平台 对账 + plan.md 增量 + 一致性校验 - 跳过：H.1 commit（仍由步骤7）/ G L2-L3 / I 度量 / K
- 恢复：完成同步后 current_step 恢复 + silent_55_count 归零 → 回到原步骤
AI 主动弹框（2 个场景）
| 场景 | 条件 | 行为 |
|---|---|---|
| A · 5.5 静默累计 ≥3 | post-step.sh 检测 silent_55_count ≥3 | ask_followup_question 必弹 |
| B · 完整模式真空期追加改动 | caller=full-7 完成后 git diff vs last_sync_diff_sha 非空 | ask_followup_question 必弹 |
防退化条款：dev:sync ≠ 5.5b 替代品。5.5b 是日常必做（freshness-lint 物理硬阻断），dev:sync 是累计静默≥3的兜底。
12. 交互模式（精简交互 + 步骤流转）
v3 设计：修饰层
streamlined仅调节交互频率，不改变基础模式。 所有决策点必须「文本选项表格 +ask_followup_question」双重展示（C1-C8 lint 强制）。
交互模式风险分级
步骤流转推进规则
精简模式仅豁免 4 处流转：0.5→1 / 4.5→5 / 5→5.5 / 5.5→6。其他所有流转任何模式都不可豁免（1→2 / 2→3 / 3→4 / 4→4.5 / 6→7 / 7→done 等）。 双重展示强制：每个决策点必须先输出文本选项表格，再调用
ask_followup_question，两者缺一视为红牌 R3。
13. Prompt Chaining 架构 + 程序化执行层
v3 升级：v2 的 Prompt Chaining 架构基础上，v3 新增程序化执行层（状态机/Hooks/Lint/预检）， 将大量门控规则从提示词下沉为脚本，以物理文件事实替代 AI 记忆。
程序化执行层组件：
- 状态机（
state-machine.sh）：数据驱动查询下一步骤（--query-next --current=N --mode=M），替代记忆查表- Hooks：
pre-step.sh（物理检查点白名单 + step5 硬卡点）/post-step.sh（Schema + lint 三合一）- 8 套 Lint：路径规范 / 选项一致性 / devlog 命名 / 文档决策 / devlog 完整性 / 文档平台 文档质量 / 工作上下文新鲜度 / 工作上下文位置
- 预检：
physical-checkpoint.sh（7 模式白名单）/step5-precheck.sh（4 项硬校验）- 元门控：
refactor-gate.sh（13 项检查守护规则系统自身一致性）
14. 源文件索引
| 文件 | 说明 |
|---|---|
SKILL.md | 主入口，触发规则+全局配置+命令速查+流程加载指令 |
flow.md | 开发流程详细指引（L0 路由层，阶段0+0.5+步骤1~10+热启动+多活跃流程） |
steps/step-router.md | 步骤路由器（执行协议+门控+物理检查点+红牌+交互规则+模式白名单） |
steps/README.md | 步骤规范目录导航 |
steps/step-1-research.md | 步骤1：研究与定位 |
steps/step-2-scope.md | 步骤2：确认范围 |
steps/step-3-plan.md | 步骤3：制定方案 |
steps/step-4-decision.md | 步骤4：方案汇报与用户决策（4环节+智能评估+文档平台+分支定稿） |
steps/step-4.5-env-check.md | 步骤4.5：环境检查（主干分支拦截） |
steps/step-5-execute.md | 步骤5：执行修改（编码前置硬卡点+TDD） |
steps/step-5.5-post-coding.md | 步骤5.5：编码后置钩子（L1审查+文档同步+ESLint） |
steps/step-6-verify.md | 步骤6：质量验证（6A自动化+6B验收+6C联调+熔断） |
steps/step-7-commit.md | 步骤7：清理+Commit（加载 closeout-flow.md） |
steps/step-8-10-full.md | 步骤8~10：完整执行扩展（L3审查+反思+归档） |
references/closeout-flow.md | 收尾子流程规范（A~K 11环节制，4种调用方共享；原名 wrapup-flow.md，2026-06-03重命名） |
references/_index.md | 参考文件加载索引 + 条件激活矩阵 |
references/mode-matrix.md | 模式矩阵（6种基础模式+1种修饰层+切换决策树+micro-fix降级条件） |
references/gate-validator.md | 门控校验规范（每步骤结构化校验+物理检查点白名单+交互式选项一致性） |
references/working-context.md | 工作上下文规则（命名+创建+更新+项目缩写映射） |
references/active-flows.md | 活跃流程注册目录（.flow v3 schema+智能恢复网关+并发抢占） |
references/iteration-fix.md | 迭代修复机制（场景分类+差异处理+快车道+文档平台继承+轮次管理） |
references/rollback.md | 回退对照表（单一真相源） |
references/drift-handling.md | 需求漂移处理子流程（三步固定动作+反模式+降级关联） |
references/cross-project-flow.md | 跨项目联调主索引（触发检测+衔接+集成+分析+单.flow架构） |
references/micro-fix-light.md | micro-fix 轻量保留版执行规范（5个环执行边界+三道防线） |
references/figma-flow.md | Figma 设计稿处理流程（两级策略） |
references/tech-proposal-flow.md | 技术方案文档生成/更新流程 |
references/in-flow-sync.md | 流程内文档同步（dev:sync 完整流程+H.0~H.3+子集） |
references/code-safety-rules.md | 代码安全规则（lint验证+自检清单） |
references/user-acceptance.md | 用户验收流程（步骤6B） |
references/integration-flow.md | 联调流程（步骤6C） |
references/interaction-mode.md | 交互模式（standard/streamlined风险分级+豁免清单） |
references/token-management.md | 对话窗口 Token 管理策略 |
references/conversation-quality.md | 对话质量守卫（长对话预警+压缩+收尾） |
references/devlog-rules.md | 开发日志生成规范 |
references/doc-sync-rules.md | 文档同步规则（三模式通用） |
references/metrics-rules.md | 流程度量机制（数据模型+采集+报告+仪表盘） |
references/core-principles.md | 核心原则详细说明（§1~§18） |
references/shared-rules.md | 共享规则单一真相源（Commit/沉淀/并行/分支/Hook） |
references/remote-knowledge.md | 知识库平台 节点信号触达（5信号+项目映射+Token策略+噪声过滤） |
references/onboard-flow.md | dev:onboard 命令流程与 profile 生命周期 |
references/output-schemas.md | 步骤完成标记 JSON 统一模板定义 |
references/schemas/all-steps.schema.json | 所有步骤完成标记 JSON 的机器可校验 Schema |
references/env-tools.md | 环境与工具信息（含 Git Worktrees） |
references/tdd-mode.md | TDD 测试驱动开发模式 |
references/react.md | React 开发专项规范 |
references/component-library.md | 组件库使用规范 |
references/flow-graph.md | 流程图定义（流转路径表） |
references/skill-full.md | SKILL.md 完整备份（P0 精简前的边界情况） |
references/no-dev-flow-mode.md | 无 dev-flow 时的简化质量检查规范 |
config/gates.yaml | 门控规则单一权威源（物理检查点+lint+hooks+状态机+工具门禁，600+行） |
config/hooks.json | Hook 注册表 |
scripts/ | 程序化执行层（63个脚本：state-machine/hooks/lints/precheck/harness/tests 等） |