From 023ae443643e8de58f4a3890ef6b3b45211ff5c0 Mon Sep 17 00:00:00 2001 From: xfy Date: Wed, 22 Jul 2026 17:39:59 +0800 Subject: [PATCH] =?UTF-8?q?docs(agents):=20=E6=96=B0=E5=A2=9E=E6=8C=89?= =?UTF-8?q?=E5=8A=9F=E8=83=BD=E7=82=B9=E6=8F=90=E4=BA=A4=E7=9A=84=E5=B7=A5?= =?UTF-8?q?=E4=BD=9C=E6=B5=81=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 要求每完成一个功能点提交一次（不攒批），提交粒度与信息由 AI 自主 决定，但只暂存相关文件、勿 git add .。 --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) 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.)