Agent self reflection
Skill findscripter/everything-skills/00-meta/agent-self-reflection
类书式 AI Agent 技能大典 · 精选/中文化/互见成网的 500+ 开源技能,可作为 Claude Code 插件市场一键安装。A curated, cross-referenced encyclopedia of 500+ open-source agent skills.
npx -y skills add findscripter/everything-skills --skill agent-self-reflectionAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
当对话陷入细节、用户喊"退一步/缩放视角/我们是不是想多了"或长时间深挖实现却无战略校验时使用;做对话的五维复盘(宏观视角/缺口分析/反思追问/偏见检查/上下文对齐),产出"流水式无小标题"评估并以 继续/转向/暂停提问 三选一的明确方向收尾;不适用于例行执行、需要写报告式结构化输出、或对话过短无可复盘上下文的场景;触发词:反思、退一步、缩放视角
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
7.5 KB, ~2.5k tokens by cl100k_base, as published. Nobody here has run it
何时使用
- 用户显式喊停:"反思""退一步""缩放视角""我们是不是漏了什么""我们是不是想多了""理一理方向""现在跑偏了吗"等任何表达"跳出细节、重新评估"意图的话。
- 隐式信号(仅"提议"反思,不要擅自启动):对话连续 10+ 轮深挖实现细节却无战略校验;用户表现出卡顿/受挫;短时间内反复撞墙或来回改方向。检测到隐式信号时,先问用户"要不要退一步看一下",而非单方面执行。
不该用的边界:
- 例行执行任务时(反思是暂停,不是边干边附带的副本——一旦边执行边"顺手反思",你会过度偏向当前方向)。
- 需要结构化报告输出时(本技能强制流水式叙述,无小标题/无项目符号)。
- 对话过短、根本没有可复盘的上下文时——此时不强行编造问题,转而问用户想复盘什么(见步骤 0)。
步骤
0. 停止指令(复盘之前)。 先中断当前线程,不要继续执行进行中的任务。复盘需要对完整对话历史的全部注意力,用户也期待一次明确的节奏中断。
1. 低介入式澄清(仅在上下文太薄时问,最多一问)。 默认直接跑分析,不提问。仅当调用上下文过薄(如用户在全新对话开头粘贴"退一步",没有可复盘的前文)时,问一个带默认值的强制选择:
具体要我复盘什么?选一个:
- 目标——我们在解对的问题吗?
- 路径——当前这条路是最优的吗?
- 假设——我们把什么当成了理所当然?
- 以上全部(有时间就默认选这个)
为什么问: 我看到可复盘的前文有限,想聚焦而非瞎猜。想三个都看就直说。
2. 五维分析框架。 从最初目标往后重读完整对话——不只是最近几轮。这是真复盘与"局部上下文摘要"的分水岭。
-
① 宏观视角: 最初目标是什么?是否偏离?偏向更好还是更坏?用具体证据锚定,例如"第 3 轮目标是 X,到第 12 轮在做 Y——Y 是对 X 的有效收窄,还是漂移?"
-
② 缺口分析: 未经验证的假设、被遗漏的干系人/受众/用户、被跳过的约束(技术/合规/资源)、被否决但值得重看的备选、范围外的外部因素(时机/市场/依赖)。
-
③ 反思追问: 问题框定对不对?是不是在解一个相邻但更简单的问题?有没有把简单路径复杂化?有没有在回避更难但更有价值的路?换个人会不会有不同做法(新鲜眼光)?
-
④ 偏见检查(五种,逐一对照对话模式取证):
偏见 识别线索 确认偏误 引用的证据只支持现有假设;反证缺席或被打发 沉没成本 "已经投入了 X""都做到这份上了",而非重新算成本/收益 锚定效应 困在第一个提到的选项;新选项只与它比较而非独立评估 复杂度偏好 不断加功能/步骤/保险措施,却给不出每一项的具体理由 近因偏误 过度看重最近几轮;更早但更重要的上下文被忽视 对每个检出的偏见:点名、引具体证据、给纠偏动作。
-
⑤ 上下文对齐: 这个方向是否服务用户的真实目标?是否忽略了外部因素?现在是否是用户时间/精力的最优用法?与用户其他已知项目/优先级有何关联?
3. 收尾方向建议(强制,三选一)。 每次复盘必须以下列之一收尾,且永远具体(绝不说"你再想想"):
| 建议 | 何时 | 格式 |
|---|---|---|
| 继续 | 路径稳健 | "继续。{为何稳健的具体理由}。" |
| 转向 {X} | 已漂移 或 浮现更优路径 | "转向 {X},放弃 {要砍掉的}。{具体证据}。" |
| 暂停问 {Q} | 有个问题必须先答 | "暂停,先答 {Q}。不答它,下一步将冒 {具体代价} 的风险。" |
指令
- 语气与格式:流水式散文,无小标题、无项目符号、无报告式结构;紧凑但充分(既不是一句话,也不是一堵墙);该批评时带具体证据直接批评,该肯定时给出"为何稳健"的具体理由。
- 拒绝模糊安慰(无理由的"看着不错!"一律否决);拒绝制造问题(路径真稳健就明说,别编问题)。
- 可选脚本(命令保持原样):
scripts/bias_pattern_detector.py—— 扫描对话文本,识别五种偏见的模式信号。scripts/conversation_depth_analyzer.py—— 统计轮数 + 检测隐式触发信号(10+ 细节轮、受挫标记)。scripts/directional_recommendation_validator.py—— 校验输出是否以 继续/转向/暂停 + 具体理由收尾。
示例
用户:盯着登录模块的重试退避算法改了一上午,突然说"退一步看看"。
复盘(流水式,节选):最初目标是"把登录失败率压下去",但从第 4 轮起我们一直在调退避曲线的常数——这是宏观目标的有效收窄,还是漂移?数据上失败的大头其实是验证码超时,而非重试节奏,这条线索在第 2 轮出现过却没追。这里有明显的锚定:所有方案都围着"退避算法"这个最先提到的选项打转。同时带点复杂度偏好——又加了抖动、又加了熔断,但没说清各自针对哪类失败。暂停,先答:失败到底卡在哪一环? 不答它,继续调退避参数将冒"优化了占比 10% 的问题、放着 60% 的验证码超时不管"的风险。
注意事项
- 隐式触发只用来"提议"反思,绝不擅自启动;不确定是否触发时,问用户而非主动执行。
- 一定从最初目标往后重读完整对话,不要只复盘最近几轮。
- 不要硬编码用户名或具体领域引用;不要在状态本就良好时编造问题;不要漏掉收尾的方向建议;不要边执行进行中任务边"顺手反思"。
互见
- 同源
capture(头脑倾倒转行动)—— 本技能是其"轻提示流"姊妹篇。 - 偏见识别可配合元认知/决策类技能;需要结构化报告时改用对应的报告型技能(本技能刻意只产出流水式叙述)。
采编自 alirezarezvani/claude-skills(MIT 许可)。
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.