| name | harness-feedback |
| description | 执行 F1-F5 结构化反馈处理流程，从问题中提炼规则并写入约束系统。Use when receiving bug reports, user feedback, review findings, or test failures. |
Harness Feedback
结构化反馈处理——从问题到规则的闭环。
何时使用
- 收到用户反馈（"这个不对"）
- Review 发现问题
- 测试失败
- 任何"需要修"的情况
- 用户说"处理反馈"或"F1-F5"
执行流程
Step 0: 收集反馈信息
如果用户在 /harness-feedback 后面直接附了内容，用那个内容。否则依次询问：
- 问题是什么？ — 等待用户描述
- 期望行为是什么？ — 等待用户回答
收集到信息后，进入 F1-F5。
F1: 记录原话
原样记录问题描述，不解读、不简化、不猜测意图。
## 反馈记录
- **来源**: [用户反馈 / Review / 测试失败 / 自查]
- **原话**: "[原样记录]"
- **时间**: [YYYY-MM-DD]
- **严重性**: [阻断 / 重要 / 建议]
F2: 分类问题层级
判断：这个问题只出现在一个地方，还是可能出现在多处？
| 层级 | 判断依据 | 修改位置 |
|---|
| 规则层 | 多处可能出现同样问题 | docs/constraints.md |
| 工具层 | 工具逻辑 bug | src/（通过 Agent） |
| 配置层 | 配置不当 | 配置文件 |
| 实例层 | 仅此一处 | 具体文件 |
F3: 提炼规则（关键步骤，禁止跳过）
从具体实例抽象为通用规则：
❌ "把登录按钮的 padding 改成 16px"
✅ "所有可交互元素在移动端最小触控区域为 44x44pt，padding ≥ 12px"
提炼方法：
- 问"还有哪些地方可能有同样问题？"
- 具体值 → 通用规则（"16px" → "≥ 12px"）
- 具体对象 → 类别（"登录按钮" → "所有可交互元素"）
- 同类问题归一条规则
F4: 写入文件
规则层问题写入 docs/constraints.md：
## C-{AREA}-{NN}: {规则标题}
{规则描述}
- **WHY**: {为什么需要这条规则}
- **违反后果**: {不遵守会怎样}
- **来源**: VH-{NN}（{日期} {问题描述}）
同时在 Violation History 中记录：
| VH-{NN} | {日期} | {发生了什么} | {根因} | C-{AREA}-{NN} |
先写规则，再派 Agent。
F5: 派 Agent 修复
修复 C-{AREA}-{NN} 违规。
读取 docs/constraints.md 中该约束的完整描述。
扫描 {范围} 中所有不符合该约束的地方，全部修复。
修复后运行 {测试命令} 确认通过。
Agent prompt 必须引用 Constraint ID。
输出
每次 F1-F5 完成后，输出处理摘要：
反馈处理完成
============
问题: {一句话描述}
层级: {规则层/工具层/配置层/实例层}
规则: C-{AREA}-{NN} — {规则标题}
违规记录: VH-{NN}
修复: Agent 已按规则修复并自验通过
AI 工具内测试准出协议
只要任务涉及代码变更，AI 不能等用户提醒才验证。按下面顺序做：
- 先判断风险等级：low / medium / high / release。
E2E PASS 不等于充分；如果只是 echo ok、空脚本、只 smoke、或没覆盖本次风险，用户报告要先说“现在还不能交付”，再说明测到了什么、没测到什么、下一步补什么；机器状态放最后，例如：机器状态：NOT_SUFFICIENT。DEGRADED 不能说成 PASS。
- 识别测试能力：单测、lint、coverage、E2E、runtime smoke。
- medium / high / release 任务必须有 E2E 证据；只有 low 小改可以不强制 E2E；找不到 E2E 入口时，先生成计划或只问一个具体启动问题。
- VERIFY 阶段必须产出 fresh evidence；没有 READY evidence 不能说“完成了”。
- 测试失败时进入修复 loop：一轮只修一个失败点，重跑最小测试，最多 3 轮；没进展就停下来说明卡点。
- 报告必须说人话：先说现在能不能交付，再说测到了什么、没测到什么、下一步补什么；不能只贴日志，也不要用 READY/NOT_READY/NOT_SUFFICIENT 开头。机器状态如果必须出现，放最后。不能把 DEGRADED 说成 PASS。
AI 可以调用 shk quality status --format json、shk e2e plan --format json、shk e2e run --format json、shk loop state --format json 作为测试准出后端检查器，但不要把这些命令丢给用户自己记。
