local-dev-workflow

name	local-dev-workflow
description	本地开发全链路 SOP。接到任务后，从需求理解到 Git 管理执行闭环。

本地开发全链路工作流（通用版）

流程：

接收需求 → 理解现状 → 方案对齐 → 编码实现 → 本地验证 → 质量门禁 → 结构文档同步 → 开发日志 → Git 管理

Step 1：需求理解

• 读取 AGENTS.md
• 按需读取目标模块代码、架构文档、近期 dev logs

Step 2：方案对齐

实施前必须明确：

1. 变更文件清单
2. 实现方式
3. 影响范围与风险

Step 3：编码实现

• 按已确认方案实施
• 保持最小改动和模块边界

Step 4：本地验证

• 对 UI/服务行为做最小可运行验证
• 非运行时变更可跳过

Step 5：质量门禁

• 调用 build-check
• 失败则修复后复跑

Step 6：结构文档同步（按需）

触发条件：新增/删除/移动文件，新增依赖或 scripts。

• 调用 repo-structure-sync

Step 7：开发日志

• 调用 dev-logs
• 记录对话、变更、验证、Git 锚点

Step 8：Git 管理

• 调用 git-management
• 在阶段成果或大改前后建立可回滚检查点