# Local Dev Workflow

> 本地开发全链路 SOP。接到任务后，从需求理解到 Git 管理执行闭环。 Use when this capability is needed.

- Skill: `tomevault-io/local-dev-workflow-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/local-dev-workflow-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/local-dev-workflow-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/local-dev-workflow-2

---


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

流程：

```text
接收需求 → 理解现状 → 方案对齐 → 编码实现 → 本地验证 → 质量门禁 → 结构文档同步 → 开发日志 → 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`
- 在阶段成果或大改前后建立可回滚检查点

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/shouxinzhang) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->