用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ShouxinZhang/AIJourney --skill local-dev-workflow命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| 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 |