feat(onboarding): AGENTS.md v1.5.0——新增需求对齐协议(Bug Fix/Feature 分类 + S 级轻量卡 + 汇总补录限定语)
This commit is contained in:
parent
85d488e831
commit
67bdacbf2e
@ -18,7 +18,7 @@
|
||||
|
||||
<!-- 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`),
|
||||
升级时有意识操作,避免 pnpm install 静默触发 ~200MB 的浏览器重下
|
||||
|
||||
## 需求对齐协议
|
||||
|
||||
开始写代码前,先判断改动类型:
|
||||
|
||||
**Bug Fix**(当前行为与预期的意外偏差)
|
||||
→ 建任务卡,直接执行,无需等确认词。
|
||||
|
||||
**Feature / 行为变更**(新增能力或主动改变已有行为)
|
||||
→ 必须先输出确认卡,等用户说「确认」再动手:
|
||||
|
||||
- **S 级**(单文件、行为对外无变化,任务卡 complexity=S):输出三行轻量卡
|
||||
```
|
||||
改哪:<文件或模块>
|
||||
改什么:<一句话>
|
||||
验收:<agent_verify 路径>
|
||||
```
|
||||
- **M / L 级**:输出完整任务卡(含 `files` + `acceptance` + `complexity`),等确认
|
||||
|
||||
**边界模糊时**:保守判断,按 Feature 处理,走完整确认卡。
|
||||
|
||||
> ⚠️ Session 结束汇总补录 ≠ 确认卡替代——补录仅适用于漂移检测触发后用户主动选择补录的场景,不得作为「先做再补」的通道。
|
||||
|
||||
## Git 工作流
|
||||
|
||||
见 `docs/ai-context/git-workflow.md`(分支策略 + Conventional Commits + Rules-Applied trailer + PR 规范)。
|
||||
|
||||
Loading…
Reference in New Issue
Block a user