retro-wx
Installation
SKILL.md
用户要求进行复盘。你的任务是向编码 agent 的环境提出改进建议,让未来的会话更顺利。
步骤
-
参考
writing-for-agents-wx技能,作为写作风格指南。 -
读取用户指定会话的一手记录。用户未指定时,默认当前会话——直接使用上下文中的记录。指定历史会话时,通过本机 agent-sessions 服务检索(
http://127.0.0.1:8390,接口用法见find-session技能;source取值codebuddy|claude|codex|pi|copilot)。服务失联时询问用户如何拉起,不要猜测本机路径。 -
在以下类别中寻找改进候选。
- 导航:agent 找到正确文件容易吗?文件之间有没有隐藏依赖?一个导航指针会不会更容易?适用场景:会话花了很久才找到某条信息。
- 自动检查:有没有自动检查能拦住 agent 犯的错?Lint、类型、测试、文件系统 linter?先读仓库自己的检查命令(
package.json/构建工具的lint/check脚本、CI workflow),已存在但没接线或静默失效的检查本身就是发现,而不是重新造一个。仓库没有任何 guardrail(没有 pre-commit hook,也没有 CI job 跑 lint/typecheck/test)本身就是一个发现:没有 lint 的仓库是长期错失的机会,不是中性默认。适用场景:agent 犯了自动检查本可拦住的错,或仓库根本没有 guardrail。 - 编码标准:应该给评审 agent 一条新规则吗?应该删除或澄清某条现有规则吗?先给违规分类:机械性违规(固定语法模式、禁用 API、import 形状、文件位置规则)直接上确定性检查——在仓库自己的 linter 里加自定义规则、加 pre-commit hook、或加 CI job,选仓库语言和现有 guardrail 下最便宜的。默认做检查,而不是写规则。
CODING_STANDARDS.md只留给真正的判断题(跨文件一致性、"与周围风格匹配"、任何 guardrail 都替代不了的)。适用场景:评审 agent 没拦住某个错误。 - 全局 AGENTS.md:有没有 steering 指令应该移到编码标准(或自动检查)里去?适用场景:AGENTS.md 文件过大——仓库里或用户全局范围的都算。
- 工具经济:agent 有没有做出本可精简的昂贵工具调用?有没有自定义工具(CLI、MCP)特别费 token?适用场景:agent 做了昂贵的工具调用。
- no-op:找找 steering 文件里不改变 agent 行为的指令。适用场景:steering 文件大而臃肿。
- 信息可达:找提升 agent 信息获取量的机会。Tee 开发服务器日志、第三方服务的只读访问。适用场景:某条关键信息 agent 拿不到。
- 按严重度排序,向用户呈现这些候选。只提议,不执行——用户选中哪条才实施哪条。