Agent Brief

Agent Brief

当 issue 进入 ready-for-agent 状态时，triage skill 产出的结构化简报。它是 AFK Agent 的工作契约，原始 issue body 只是上下文。

写作原则

持久性 > 精确性

Issue 可能在 ready-for-agent 停留数天/数周，代码库会变。

• ✅ 描述接口、类型、行为契约
• ❌ 引用文件路径、行号

行为性，非程序性

描述 做什么，不描述 怎么做。

• ✅ "SkillConfig 类型应接受可选的 schedule 字段"
• ❌ "打开 src/types/skill.ts 在第 42 行添加 schedule"

完整验收标准

每条标准独立可验证。

模板

## Agent Brief

**Category:** bug / enhancement
**Summary:** 一句话描述

**Current behavior:** 当前行为
**Desired behavior:** 期望行为
**Key interfaces:** 需要修改的接口
**Acceptance criteria:** 可测试的检查清单
**Out of scope:** 不在此范围内的事项

Triage 状态机

Issue 在五个状态间流转：

1. needs-triage → 需评估
2. needs-info → 等报告者补充
3. ready-for-agent → AFK Agent 可接手
4. ready-for-human → 需人实现
5. wontfix → 不处理

每个 issue 同时携带一个分类标签（bug/enhancement）和一个状态标签。

.out-of-scope/ 知识库

被拒绝的功能请求持久化存储。按概念（不是按 issue）组织。新 issue 进来时，检查是否与已有拒绝匹配。这防止反复争论已决定的事。