docs(agents): 新增按功能点提交的工作流规则

要求每完成一个功能点提交一次(不攒批),提交粒度与信息由 AI 自主
决定,但只暂存相关文件、勿 git add .。
This commit is contained in:
xfy 2026-07-22 17:39:59 +08:00
parent 7d8e0fca61
commit 023ae44364

View File

@ -68,6 +68,13 @@ Profiling & profiles (device required):
./scripts/analyze-trace.sh [logs/trace_*.perfetto-trace] # post-hoc SQL analysis
```
## Workflow
- **每完成一个功能点,提交一次。** 不要攒着最后一起提交。一个"功能点"是一个可独立说明的小块改动(一个 bug 修复、一个 Composable、一组测试、一次重构而不是整次会话的全部产出。
- **提交粒度与信息由 AI 自主决定**:自行判断该功能点属于 `feat` / `fix` / `refactor` / `docs` / `test` / `chore`,写清摘要;改动小则合并提交,改动跨多步则在每步落盘。
- 只暂存本次功能点相关的文件,不要 `git add .` 把无关改动(如会话前遗留的脏文件)一并带入。提交前看一眼 `git status`
- 当前在 `main` 分支:按仓库惯例可以直接在 `main` 上提交常规改动;如改动涉及发布或需评审,先开分支。
## Code Conventions & Common Patterns
- **KDoc required** on every public `@Composable`: document parameters and *when callbacks fire*. (This is the missing `COMMENTS.md` contract.)