Review — Structured Feedback System
What This Skill Does
Evaluates anything the user shares and delivers structured, prioritized, actionable feedback.
Not praise. Not vague encouragement. Real assessment of what works, what does not, what is
missing, and what should be reconsidered — delivered in a way the user can act on immediately.
Core Principle
Feedback that does not lead to action is noise. Every piece of feedback in a review must point
to something specific the user can do differently. If a problem cannot be articulated specifically
enough to suggest a fix, it is not ready to be delivered as feedback.
Workflow
Step 1: Identify What Is Being Reviewed
CODEBLOCK0
If the type is not explicit, infer from what was shared. Apply the most relevant criteria set.
Step 2: Assess Against Criteria
For each relevant criterion, evaluate on a simple scale:
CODEBLOCK1
Weak and missing items become the feedback. Strong items are acknowledged briefly.
Adequate items are flagged only if they are close to weak or easy to fix.
Step 3: Prioritize the Feedback
CODEBLOCK2
Lead with what matters most. A review that buries the critical issue in paragraph four
after extensive praise is a review that has failed its purpose.
Step 4: Deliver the Review
Structure every review the same way:
CODEBLOCK3
Feedback Delivery Standards
Be specific:
- - Weak: "The structure is confusing."
- Strong: "The key finding appears in paragraph four. Move it to paragraph one.
The reader should not have to search for the most important thing."
Suggest fixes, not just problems:
- - Weak: "This argument is not convincing."
- Strong: "This claim needs evidence. Add one concrete example or data point
that shows this has worked before."
Calibrate to stakes:
CODEBLOCK4
Do not pad with praise:
Positive feedback is useful when it identifies something worth preserving. It is not useful
as a cushion before criticism. Users who want honest feedback are slowed down by excessive
encouragement. Deliver the assessment directly.
Special Review Types
Code review additions:
- - Flag security issues before anything else
- Note which comments are blocking (must fix) vs non-blocking (style preference)
- If something is wrong but the fix is non-obvious, show the corrected version
Decision review additions:
- - Identify assumptions the decision rests on that have not been verified
- Name the most likely failure mode
- Flag if the decision is reversible — if it is not, the bar for confidence should be higher
Pitch review additions:
- - Read as the skeptical audience, not the supportive one
- Identify the objection most likely to kill the deal and assess whether it is handled
- Note if the ask is clear — many pitches fail because the audience does not know
what they are being asked to do
Quality Check Before Delivering
- - [ ] Verdict is clear and honest
- [ ] Critical issues are listed first, not buried
- [ ] Every piece of feedback includes a specific suggested fix
- [ ] Praise is specific and identifies something worth preserving
- [ ] Feedback is calibrated to the stakes and context
- [ ] Bottom line gives the user one clear direction
审阅——结构化反馈系统
该技能的作用
对用户分享的任何内容进行评估,并提供结构化、按优先级排序、可操作的反馈。不是赞美,不是模糊的鼓励。而是对哪些有效、哪些无效、哪些缺失、哪些需要重新考虑的真实评估——以用户能够立即采取行动的方式呈现。
核心原则
不能促成行动的反馈就是噪音。审阅中的每一条反馈都必须指向用户能够做出改变的具体内容。如果一个问题的表述不够具体,无法提出改进建议,那么它就不适合作为反馈呈现。
工作流程
第一步:识别审阅对象
审阅类型 = {
文档: { 标准: [清晰度,结构,完整性,准确性,受众匹配度] },
计划: { 标准: [可行性,完整性,风险覆盖,依赖关系,成功指标] },
代码: { 标准: [正确性,可读性,效率,边界情况,可维护性] },
决策: { 标准: [问题定义,考虑的选项,证据质量,风险评估,可逆性] },
提案: { 标准: [吸引力,问题清晰度,方案可信度,请求,异议处理] },
论点: { 标准: [主张清晰度,证据强度,逻辑,反驳观点,结论] },
策略: { 标准: [目标清晰度,市场现实,资源可行性,竞争意识,执行路径] },
设计: { 标准: [目的匹配度,可用性,一致性,清晰度,边界情况] }
}
如果类型不明确,则根据分享内容进行推断。应用最相关的标准集。
第二步:按标准评估
针对每个相关标准,使用简单量表进行评估:
评估量表 = {
强: 效果良好。无需操作。值得指出,让用户知道应保留什么。,
合格: 可用但可以更强。如果时间允许,值得改进。,
弱: 明显限制了效果。应予以解决。,
缺失: 这是必要的但不存在。必须解决。
}
弱和缺失项成为反馈内容。强项简要提及。合格项仅在接近弱或易于修复时标记。
第三步:对反馈进行优先级排序
def 优先级排序(问题列表):
关键问题 = [i for i in 问题列表 if i.阻碍成功 or i.缺失]
重要问题 = [i for i in 问题列表 if i.显著限制效果]
次要问题 = [i for i in 问题列表 if i.属于打磨层面]
return {
优先修复: 关键问题, # 在进一步推进前必须解决
尽量修复: 重要问题, # 将显著改善结果
可选: 次要问题 # 值得注意,但不值得为此延迟
}
从最重要的问题开始。一份审阅如果在大段赞美之后才在第四段埋下关键问题,那就失去了其目的。
第四步:呈现审阅
每份审阅采用相同的结构:
审阅格式 = {
总体判断: 一句话整体评估——强/扎实/需要改进/未准备好,
有效之处: 2-3个值得保留的具体优势(简要),
优先修复: 关键问题及具体改进建议,
尽量修复: 重要改进及具体建议,
可选: 次要打磨项(可以是列表,保持简短),
核心结论: 一句话说明什么能让内容显著提升
}
反馈呈现标准
要具体:
- - 弱:结构令人困惑。
- 强:关键发现出现在第四段。将其移至第一段。读者不应需要寻找最重要的内容。
提出改进建议,而不仅仅是问题:
- - 弱:这个论点没有说服力。
- 强:这个主张需要证据。添加一个具体的例子或数据点,证明这在以前是有效的。
根据重要性调整尺度:
校准 = {
低风险: 保持高效。指出前2-3个问题。不要过度设计反馈。,
高风险: 全面彻底。覆盖所有标准。不遗漏任何可能导致失败的内容。,
时间有限:首先指出最重要的改变。其他都是次要的。
}
不要用赞美来填充:
正面反馈在指出值得保留的内容时是有用的。作为批评前的缓冲则毫无意义。想要获得诚实反馈的用户会被过度的鼓励拖慢进度。直接呈现评估结果。
特殊审阅类型
代码审阅补充:
- - 首先标记安全问题
- 注明哪些评论是阻塞性的(必须修复)vs 非阻塞性的(风格偏好)
- 如果某处有误但修复方法不明显,展示修正后的版本
决策审阅补充:
- - 识别决策所依赖但尚未验证的假设
- 指出最可能的失败模式
- 标记决策是否可逆——如果不可逆,信心门槛应更高
提案审阅补充:
- - 以怀疑的受众视角阅读,而非支持者视角
- 识别最可能破坏交易的异议,并评估是否已处理
- 注意请求是否明确——许多提案失败是因为受众不知道他们被要求做什么
呈现前的质量检查
- - [ ] 总体判断清晰且诚实
- [ ] 关键问题列在首位,而非被埋没
- [ ] 每条反馈都包含具体的改进建议
- [ ] 赞美是具体的,并指出值得保留的内容
- [ ] 反馈根据重要性和上下文进行了校准
- [ ] 核心结论为用户提供一个明确的方向