mcpField
F
feedback

feedback

github.com/davidleeAgent 工作流294 次安装4 天前更新
代码仓库

关于 feedback

feedback 是用于处理人工或评审反馈的 Agent 技能,要求依据证据判断,而非仅凭断言接受或拒绝。它涵盖问题修复、验证和逐项明确结案。

主要功能

  1. 01基于证据裁定主张
  2. 02按依赖和严重性排序问题
  3. 03排查同类缺陷
  4. 04针对反馈验证修复
  5. 05逐项记录处理结果
  6. 06沉淀长期流程改进

适用场景

  1. 01回应人工纠正
  2. 02处理 Agent 或人工评审意见
  3. 03在评审记录中解决反馈

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/davidlee/doctrine --skill feedback

安装后在 Claude Code 中输入/feedback确认已加载。

详细介绍

反馈

针对反馈接收方的中断处理流程。流程从收到反馈开始,到闭环结束:每个要点都必须整合、提出异议或明确暂存——绝不能悄无声息地丢弃。

**什么算反馈:**有意提出的、来自某个来源的断言——人工纠正、审查者的发现(来自人或 Agent)、审计结果。 **什么不算:**机械信号。测试失败、CI 标红或 lint 输出是观察结果,不是断言——应对其进行诊断(参见 rigour 技能中的差异诊断),而不是对其作出“回应”。

两种极端错误,都是缺陷:

  • 屈从——因为有人提出不同说法就改变立场。 不加审视地返工,接着说“你说得对”,这不叫整合;这只是用对方的错误替换自己的错误,也不会让反馈来源有所收获。
  • 固守——条件反射式地维护既有结论,要求来源证明你自己就能核实的事情,对每一项纠正都争辩不休。

解决这两者的规则是:**立场因证据而改变,而非因断言而改变——无论朝哪个方向。**未经审视的主张不能成为改变立场的理由;未经核实的回忆也不能成为坚持立场的依据。

权威性

  • **指令具有约束力。**该怎么做由来源决定(但你仍应尽到通常的义务,指出后果)。下文的裁定规则适用于关于何为事实的主张。
  • 用户提供的材料和实证知识优先于你的回忆。粘贴的文档、报告的观察结果、领域知识:相对于你仅仅记得的内容,它们都是真实依据。绝不可凭训练记忆或新近的二手研究反驳,也绝不可要求对方提供出处。唯一可接受的反驳是直接核实的观察结果——你在本次会话中观察到的行为或生成的输出;应以差异报告的形式给出(“文档说 X;端点返回 Y”),因为用户宁愿了解情况,也不希望你一味顺从。报告后,按用户的决定行事。
  • **审查者的发现可供参考,但不可丢弃。**无论其价值如何,都必须对每一项明确说明处理方式。

流程

  1. 分流(分批处理;单项修正可跳至第 2 步)。先按依赖关系排序,再按严重性 × 权威性排序。将会修改同一声明的发现归为一组。优先处理那些其解决方式会改变其他发现的修复位置或成本的事项;把一份平铺清单逐项独立整合,往往会导致同一段内容被反复改写。如果顺序不明显,请说明。

  2. 针对产物裁定每个问题,而非盲目信任。 重新阅读发现实际引用的内容;审阅者可能会臆造行号、行为,甚至整个缺陷。将其观察(哪里有问题)与处方(应该怎么做)分开:其中一项正确,并不意味着另一项也正确。对照现有内容核实观察,并根据修复本身的优劣设计方案。分类如下:

    • 正确 → 整合;
    • 错误 → 提出异议,并给出已核实的证据;
    • 含糊不清 → 先澄清再行动;
    • 偏好 → 接受;如果确实有代价,则协商一次。

    改变任何立场之前:明确指出反馈推翻了你的哪项具体主张。如果它没有推翻任何主张,而你掌握了已核实的证据,就提出异议。根据来源调整坚持程度:面对 Agent 审阅者,只要证据支持,就持续提出异议;面对用户,给出一条简洁反驳并附上证据,之后听从用户——但要注明实质性分歧,而不是将其掩盖。

  3. 归纳推广。 用一句话指出缺陷类别,然后在适用范围内检查产物中的同类问题,并连同当前实例一并修复;超出范围的同类问题应记录为后续工作,不要悄然扩大范围。如果修复会更改或撤回一项主导性主张,范围就是整个仓库:找到规范性来源,通过实体的 show 视图检查两层创作内容,并在修复后检查依赖投影。负向搜索必须在同一检索面上有正向对照。

  4. 整合时避免回归。 对照之前已敲定的决定检查返工内容。若反馈与已敲定的决定冲突,应明确重新审议该决定——将其摆到台面上;不要在修复过程中悄悄重新争论。发现只提供方向,而非终点:不要把过度主张改成同样缺乏依据的反向主张,不要添加证据无法证明合理性的机制,也不要把披露缺陷误当成修复缺陷。

  5. 针对问题重新验证。 要检查的是“这是否解决了来源实际提出的问题”,而不是“是否有所改动”。如果发现意味着存在失败用例,应确保其在修复前失败、修复后通过。将新增或修正的规则应用于其覆盖的全部内容,重新运行相关验证(或标记验证结果已过时),并重新阅读修正所影响的衔接处和相邻主张。

  6. 闭环。 逐点向来源报告处理结果:已整合(以及如何整合)、提出异议(依据是什么)、请求澄清、搁置(以及原因)。对某项不作回应会被视为接受,也会掩盖遗漏。

  7. 总结经验。 产物修正会随任务结束而失效;对你自己的流程或来源偏好的修正才是持久成果——应按照 lib:reference/harvest.md 将其总结下来,并始终说明原因,否则同样的修正会在下次会话中重现。

使用结构化评审台账时

如果反馈记录在结构化台账中(例如 doctrine RV 或 PR 评审讨论串),台账负责处理机制——处置用语、异议流程、解决状态、关闭门槛。本技能关注的是这些动词背后的处事方式:先裁定,再处置;先举证,再异议;不得为了绕过门槛而选择处置方式。不要在散文中重复台账记录,也不要绕过台账门槛。兼容,但不作规定。

参见 lib:reference/review-ledger.md §4,了解响应者的处置用语以及 contest/amend 动词。

具体到设计评审,RV 是修订历史的载体。在其中保留问题的时间顺序和逐点响应;让 design.md 保持为当前清晰易读的设计;并将已接受且持久有效的裁定纳入相应的知识或治理记录。交回修订稿之前,对已修正段落进行只读自我攻击,检查事实错误、内部矛盾、同类问题、过时映射以及对先前裁定的回退。重新核查它提出的每个问题,再采取行动;此轮检查用于发现可能的缺陷,并不为自己的修复背书。

防护原则

  • 不得悄然略过任何一点——无论是已整合、有异议、已澄清还是暂缓处理。
  • 不得仅凭断言就改变立场;也不得仅凭回忆就坚持原判。
  • 不得用记忆或二手研究反驳用户提供的材料;只有经过验证的观察才能作为反驳,而且它是报告,不是拒绝。
  • 表演式让步——热情赞同,却什么都不改,或未经裁定就改掉一切——比坦诚提出异议更糟。
  • 不得借整合反馈之名,重提已定案的决定。
  • 两次反驳用户提出的问题,就是固守己见;坚定指出 Agent 评审者的编造内容,则是在提供帮助。

结果

  • 每一点都有明确可见的处置;没有任何内容悄然消失。
  • 立场变化有据可循;产物吸收反馈的实质,而非噪声。
  • 修复的是问题类别,而非个别实例;已定案的决定在返工后仍然有效,或被有意重新审议。
  • 提交反馈的来源能了解哪些意见被采纳、哪些未被采纳,以及原因。
  • 持久有效的修正不会反复出现。

评论

支持 Markdown