feat(onboarding): AGENTS.md v1.5.0——新增需求对齐协议(Bug Fix/Feature 分类 + S 级轻量卡 + 汇总补录限定语)

This commit is contained in:
lanrtop 2026-07-09 16:12:47 +09:00
parent 85d488e831
commit 67bdacbf2e

View File

@ -18,7 +18,7 @@
<!-- TODO: 列出 README / ARCHITECTURE.md / 其他关键文档及用途。 --> <!-- TODO: 列出 README / ARCHITECTURE.md / 其他关键文档及用途。 -->
<!-- ONBOARDING_MANAGED_START version="1.4.0" --> <!-- ONBOARDING_MANAGED_START version="1.5.0" -->
## 核心开发约束 ## 核心开发约束
### 包管理 ### 包管理
@ -35,6 +35,28 @@
另建 `test:install` 脚本显式安装浏览器(`playwright install --with-deps` 另建 `test:install` 脚本显式安装浏览器(`playwright install --with-deps`
升级时有意识操作,避免 pnpm install 静默触发 ~200MB 的浏览器重下 升级时有意识操作,避免 pnpm install 静默触发 ~200MB 的浏览器重下
## 需求对齐协议
开始写代码前,先判断改动类型:
**Bug Fix**(当前行为与预期的意外偏差)
→ 建任务卡,直接执行,无需等确认词。
**Feature / 行为变更**(新增能力或主动改变已有行为)
→ 必须先输出确认卡,等用户说「确认」再动手:
- **S 级**(单文件、行为对外无变化,任务卡 complexity=S输出三行轻量卡
```
改哪:<文件或模块>
改什么:<一句话>
验收:<agent_verify 路径>
```
- **M / L 级**:输出完整任务卡(含 `files` + `acceptance` + `complexity`),等确认
**边界模糊时**:保守判断,按 Feature 处理,走完整确认卡。
> ⚠️ Session 结束汇总补录 ≠ 确认卡替代——补录仅适用于漂移检测触发后用户主动选择补录的场景,不得作为「先做再补」的通道。
## Git 工作流 ## Git 工作流
见 `docs/ai-context/git-workflow.md`(分支策略 + Conventional Commits + Rules-Applied trailer + PR 规范)。 见 `docs/ai-context/git-workflow.md`(分支策略 + Conventional Commits + Rules-Applied trailer + PR 规范)。