القائمة
本地开发全链路 SOP。接到任何开发任务时，按此流程从需求理解到 Git 管理完整执行，串联所有子 Skills 形成闭环。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
代码构建全链路质量门禁。当你完成代码修改后，必须使用此技能运行构建检查确保代码质量。适用于任何前端代码变更后的验证。
依赖关系优先的 AI Review 总调度 Skill。通过“机械门禁 + LLM 判读 + 人工兜底”输出可执行评审结论。
开发日志记录规范。每次完成代码修改后，必须使用此技能记录开发日志到 docs/dev_logs/ 目录。当你完成任何代码变更、Bug 修复、功能开发或重构时，使用此技能。
通用模块化治理 Skill。用于通过机械量化脚本检查模块边界、依赖方向、循环依赖与变更风险，并以 PASS/REFINE/BLOCK 输出可修复反馈。适用于 LLM 分治式开发中的框架校验、自动 review 闭环、以及模块重构验收。
Git 管理规范。出现阶段性成果或准备进行大改动时，使用此技能建立可回滚、可追溯的版本控制节奏。
仓库架构文档同步。当文件结构发生变化（新增/删除/移动文件或目录）时，必须使用此技能更新仓库元数据和架构文档。
| name | local-dev-workflow |
| description | 本地开发全链路 SOP。接到任何开发任务时，按此流程从需求理解到 Git 管理完整执行，串联所有子 Skills 形成闭环。 |
这是一个"总调度"技能，定义 Agent 从接到开发任务到代码进入版本库的完整流程。每个步骤明确做什么、怎么验证、何时进入下一步。
接收需求 → 理解现有代码 → 方案对齐 → 编码实现 → 本地预览 → 质量门禁 → 架构文档同步 → 开发日志 → Git 管理
做什么：读取项目规范和现有架构，理解上下文。
必读：
AGENTS.md — 行为规范、正负面 Prompt兜底读取（仅在下列场景触发）：
docs/architecture/repository-structure.md — 当变更范围不清晰、MCP 不可用、或涉及跨模块影响评估时可选读取（按需）：
docs/dev_logs/ 近期开发日志，了解最近改了什么完成标志：清楚知道项目当前的技术栈、目录结构、编码规范。
做什么：先向用户描述实现方案，等用户确认后再动手。
必须包含：
完成标志：用户明确表示 OK / 可以 / 开始。
⚠️ 绝不跳过此步骤直接写代码。这是 AGENTS.md 的硬性要求。
做什么：按确认的方案编写代码。
编码规范（摘自 AGENTS.md）：
如涉及知识图谱数据：
knowledge-tree-update skill 的规范完成标志：代码编写完成，准备验证。
做什么：启动开发服务器，确认页面效果正常。
cd web && npm run dev
检查要点：
完成标志：页面视觉和交互符合预期。
💡 对于纯数据/配置变更或非前端代码，此步骤可跳过。
做什么：运行全链路构建检查。
→ 调用 build-check skill
bash scripts/check_errors.sh
如有测试文件变更，额外运行：
cd web && npm run test
完成标志：所有检查项均为 ✔ 通过。如有失败，修复后重新运行直到全部通过。
⚠️ 质量门禁不通过，禁止进入后续步骤。
做什么：如果本次开发涉及文件结构变化（新增/删除/移动文件或目录），更新架构文档。
→ 调用 repo-structure-sync skill
触发条件：
完成标志：docs/architecture/repository-structure.md 与实际文件结构一致。
💡 如果本次只修改了现有文件内容（未新增/删除），此步骤可跳过。
做什么：记录本次开发的完整日志。
→ 调用 dev-logs skill
日志文件路径：docs/dev_logs/{YYYY-MM-DD}/{序号}-{简短描述}.md
必须包含：
完成标志：日志文件已创建，内容完整。
做什么：根据任务风险使用 git-management skill 管理提交节奏和保护点。
→ 调用 git-management skill
最小要求：
完成标志：
💡 只做 commit，是否 push 由用户决定。如用户要求了 push，执行
git push。
| # | 步骤 | 可跳过？ | 关联 Skill |
|---|---|---|---|
| 1 | 需求理解 | ❌ | — |
| 2 | 方案对齐 | ❌ | — |
| 3 | 编码实现 | ❌ | knowledge-tree-update（按需） |
| 4 | 本地预览 | ✅ 非前端变更可跳 | — |
| 5 | 质量门禁 | ❌ | build-check |
| 6 | 架构文档同步 | ✅ 无文件结构变化可跳 | repo-structure-sync |
| 7 | 开发日志 | ❌ | dev-logs |
| 8 | Git 管理 | ❌ | git-management |