# workflow

## 字多不看

- 本目录收敛项目开发流程，回答“从接到任务到提交推送应该怎么做”。
- 默认流程是：明确目标、读取上下文、制定计划、执行修改、运行门禁、检查差异、控制版本、推送远端、同步文档。
- 涉及目录、命令、配置、质量门禁或版本控制变化时，必须同步更新对应 README / AGENTS / 索引。
- 流程要能执行、检查和复用，不写只适合一次性任务的日志。

## 快速导航

1. [开发流程](#workflow-development-process) - 项目默认开发顺序、检查节点和交付闭环。

<details>
<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>

### 细粒度目录

- [1. 开发流程](#workflow-development-process)

</details>

## 使用方式

- 开始任务前，先按本文档确认任务顺序和验收节点。
- 需要执行 Git、提交或推送时，同时遵循根目录 `AGENTS.md` 中的版本控制规则。
- 修改流程内容后，运行 `make sync-doc-toc` 和 `make test`。

## 正文

---

<details>
<summary><strong>1. 开发流程</strong> - 默认任务推进顺序、质量门禁和交付闭环。（点击展开/收起）</summary>

<a id="workflow-development-process"></a>

## 1. 开发流程

默认开发流程：

1. 明确目标：写清楚要做什么、不要做什么、成功标准是什么。
2. 读取上下文：先看 README、AGENTS、相关目录说明和现有实现。
3. 制定计划：把任务拆成可验证的小步骤，必要时先给用户确认。
4. 执行修改：按最小影响面修改文件，不顺手重构无关内容。
5. 运行门禁：至少运行 `make test`；涉及专项工具时补对应验证命令。
6. 检查差异：用 `git diff` 确认没有混入临时文件、敏感信息或无关改动。
7. 控制版本：使用语义清晰的 commit 记录阶段性成果。
8. 推送远端：默认推送当前 `develop` 分支，并观察 GitHub Actions 结果。
9. 同步文档：目录、命令、配置、流程变化必须同步 README / AGENTS / 对应索引。

</details>