mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-02 21:57:44 +00:00
docs: move workflow under docs
This commit is contained in:
@@ -0,0 +1,31 @@
|
||||
# workflow Agent 指南
|
||||
|
||||
## 目录职责
|
||||
|
||||
`docs/workflow/` 存放项目开发流程类 Markdown,是开发顺序、质量门禁、版本控制和文档同步规则的流程入口。
|
||||
|
||||
## 文件地图
|
||||
|
||||
```text
|
||||
workflow/
|
||||
├── README.md # 线性总文档:开发流程集合
|
||||
└── AGENTS.md # 本目录操作规则
|
||||
```
|
||||
|
||||
## 修改规则
|
||||
|
||||
- 继承 `docs/AGENTS.md` 的 README 结构契约:H1 后直接进入 `## 字多不看`,再按 `快速导航 -> 完整细粒度目录 -> 使用方式 -> 正文` 排列。
|
||||
- 本目录只放流程类文档,不放一次性任务记录、日志、源码快照或私密配置。
|
||||
- 新增流程时优先追加到 `README.md`,不新增同级主题 `.md` 文件。
|
||||
- 新增流程必须能被执行、检查和复用,避免只写抽象口号。
|
||||
- 涉及命令、路径、配置、CI、Git 操作时,必须与仓库当前事实一致。
|
||||
- 不在本目录保存密钥、Token、本地账号、真实私有项目配置或一次性日志。
|
||||
- 架构、目录、命令或质量门禁发生变化时,同步更新本目录和根 `README.md` / `AGENTS.md`。
|
||||
- 不在 README 正文中写 `和其他目录的边界` 或 `维护规则`;维护者规则只写本文件。
|
||||
- 不确定项标注 TODO,并说明需要哪个文件或命令输出才能确认。
|
||||
|
||||
## 验证
|
||||
|
||||
```bash
|
||||
make test
|
||||
```
|
||||
@@ -0,0 +1,52 @@
|
||||
# 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>
|
||||
Reference in New Issue
Block a user