diff --git a/AGENTS.md b/AGENTS.md index 4715613..68faaed 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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.)