메뉴
本地开发全链路 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 |