关于 feedback
feedback 是用于处理人工或评审反馈的 Agent 技能,要求依据证据判断,而非仅凭断言接受或拒绝。它涵盖问题修复、验证和逐项明确结案。
主要功能
- 01基于证据裁定主张
- 02按依赖和严重性排序问题
- 03排查同类缺陷
- 04针对反馈验证修复
- 05逐项记录处理结果
- 06沉淀长期流程改进
适用场景
- 01回应人工纠正
- 02处理 Agent 或人工评审意见
- 03在评审记录中解决反馈
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ davidlee/ doctrine --skill feedback安装后在 Claude Code 中输入/feedback确认已加载。
详细介绍
反馈
针对反馈接收方的中断处理流程。流程从收到反馈开始,到闭环结束:每个要点都必须整合、提出异议或明确暂存——绝不能悄无声息地丢弃。
**什么算反馈:**有意提出的、来自某个来源的断言——人工纠正、审查者的发现(来自人或 Agent)、审计结果。
**什么不算:**机械信号。测试失败、CI 标红或 lint 输出是观察结果,不是断言——应对其进行诊断(参见 rigour 技能中的差异诊断),而不是对其作出“回应”。
两种极端错误,都是缺陷:
- 屈从——因为有人提出不同说法就改变立场。 不加审视地返工,接着说“你说得对”,这不叫整合;这只是用对方的错误替换自己的错误,也不会让反馈来源有所收获。
- 固守——条件反射式地维护既有结论,要求来源证明你自己就能核实的事情,对每一项纠正都争辩不休。
解决这两者的规则是:**立场因证据而改变,而非因断言而改变——无论朝哪个方向。**未经审视的主张不能成为改变立场的理由;未经核实的回忆也不能成为坚持立场的依据。
权威性
- **指令具有约束力。**该怎么做由来源决定(但你仍应尽到通常的义务,指出后果)。下文的裁定规则适用于关于何为事实的主张。
- 用户提供的材料和实证知识优先于你的回忆。粘贴的文档、报告的观察结果、领域知识:相对于你仅仅记得的内容,它们都是真实依据。绝不可凭训练记忆或新近的二手研究反驳,也绝不可要求对方提供出处。唯一可接受的反驳是直接核实的观察结果——你在本次会话中观察到的行为或生成的输出;应以差异报告的形式给出(“文档说 X;端点返回 Y”),因为用户宁愿了解情况,也不希望你一味顺从。报告后,按用户的决定行事。
- **审查者的发现可供参考,但不可丢弃。**无论其价值如何,都必须对每一项明确说明处理方式。
流程
-
分流(分批处理;单项修正可跳至第 2 步)。先按依赖关系排序,再按严重性 × 权威性排序。将会修改同一声明的发现归为一组。优先处理那些其解决方式会改变其他发现的修复位置或成本的事项;把一份平铺清单逐项独立整合,往往会导致同一段内容被反复改写。如果顺序不明显,请说明。
-
针对产物裁定每个问题,而非盲目信任。 重新阅读发现实际引用的内容;审阅者可能会臆造行号、行为,甚至整个缺陷。将其观察(哪里有问题)与处方(应该怎么做)分开:其中一项正确,并不意味着另一项也正确。对照现有内容核实观察,并根据修复本身的优劣设计方案。分类如下:
- 正确 → 整合;
- 错误 → 提出异议,并给出已核实的证据;
- 含糊不清 → 先澄清再行动;
- 偏好 → 接受;如果确实有代价,则协商一次。
改变任何立场之前:明确指出反馈推翻了你的哪项具体主张。如果它没有推翻任何主张,而你掌握了已核实的证据,就提出异议。根据来源调整坚持程度:面对 Agent 审阅者,只要证据支持,就持续提出异议;面对用户,给出一条简洁反驳并附上证据,之后听从用户——但要注明实质性分歧,而不是将其掩盖。
-
归纳推广。 用一句话指出缺陷类别,然后在适用范围内检查产物中的同类问题,并连同当前实例一并修复;超出范围的同类问题应记录为后续工作,不要悄然扩大范围。如果修复会更改或撤回一项主导性主张,范围就是整个仓库:找到规范性来源,通过实体的
show视图检查两层创作内容,并在修复后检查依赖投影。负向搜索必须在同一检索面上有正向对照。 -
整合时避免回归。 对照之前已敲定的决定检查返工内容。若反馈与已敲定的决定冲突,应明确重新审议该决定——将其摆到台面上;不要在修复过程中悄悄重新争论。发现只提供方向,而非终点:不要把过度主张改成同样缺乏依据的反向主张,不要添加证据无法证明合理性的机制,也不要把披露缺陷误当成修复缺陷。
-
针对问题重新验证。 要检查的是“这是否解决了来源实际提出的问题”,而不是“是否有所改动”。如果发现意味着存在失败用例,应确保其在修复前失败、修复后通过。将新增或修正的规则应用于其覆盖的全部内容,重新运行相关验证(或标记验证结果已过时),并重新阅读修正所影响的衔接处和相邻主张。
-
闭环。 逐点向来源报告处理结果:已整合(以及如何整合)、提出异议(依据是什么)、请求澄清、搁置(以及原因)。对某项不作回应会被视为接受,也会掩盖遗漏。
-
总结经验。 产物修正会随任务结束而失效;对你自己的流程或来源偏好的修正才是持久成果——应按照
lib:reference/harvest.md将其总结下来,并始终说明原因,否则同样的修正会在下次会话中重现。
使用结构化评审台账时
如果反馈记录在结构化台账中(例如 doctrine RV 或 PR 评审讨论串),台账负责处理机制——处置用语、异议流程、解决状态、关闭门槛。本技能关注的是这些动词背后的处事方式:先裁定,再处置;先举证,再异议;不得为了绕过门槛而选择处置方式。不要在散文中重复台账记录,也不要绕过台账门槛。兼容,但不作规定。
参见 lib:reference/review-ledger.md §4,了解响应者的处置用语以及 contest/amend 动词。
具体到设计评审,RV 是修订历史的载体。在其中保留问题的时间顺序和逐点响应;让 design.md 保持为当前清晰易读的设计;并将已接受且持久有效的裁定纳入相应的知识或治理记录。交回修订稿之前,对已修正段落进行只读自我攻击,检查事实错误、内部矛盾、同类问题、过时映射以及对先前裁定的回退。重新核查它提出的每个问题,再采取行动;此轮检查用于发现可能的缺陷,并不为自己的修复背书。
防护原则
- 不得悄然略过任何一点——无论是已整合、有异议、已澄清还是暂缓处理。
- 不得仅凭断言就改变立场;也不得仅凭回忆就坚持原判。
- 不得用记忆或二手研究反驳用户提供的材料;只有经过验证的观察才能作为反驳,而且它是报告,不是拒绝。
- 表演式让步——热情赞同,却什么都不改,或未经裁定就改掉一切——比坦诚提出异议更糟。
- 不得借整合反馈之名,重提已定案的决定。
- 两次反驳用户提出的问题,就是固守己见;坚定指出 Agent 评审者的编造内容,则是在提供帮助。
结果
- 每一点都有明确可见的处置;没有任何内容悄然消失。
- 立场变化有据可循;产物吸收反馈的实质,而非噪声。
- 修复的是问题类别,而非个别实例;已定案的决定在返工后仍然有效,或被有意重新审议。
- 提交反馈的来源能了解哪些意见被采纳、哪些未被采纳,以及原因。
- 持久有效的修正不会反复出现。