AGENT SKILL
retro
对一次编码会话进行复盘。
- License 许可
- MIT
- 最近更新
- 2026-10-19
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- retro
- description
- 对一次编码会话进行复盘。
- commit_version
- a7d038f6bf7f01b516408e95e2fb56e0b338fa6f
- disable-model-invocation
- true
02 资源文件 1
- 参考文档agents/openai.yaml135 B
03 SKILL.md 正文
用户要求进行复盘(retrospective)。你要为编码 agent 的环境提出改进建议,以改善未来的运行。
步骤
-
调用 Skill 工具获取
writing-for-agents,查看写作风格指南。 -
阅读用户指定会话的一手来源。这可能意味着要在这台机器上搜索会话日志。如果用户没有指定会话,默认使用当前会话。
-
在以下类别中寻找改进候选。
- 导航(Navigation):agent 找到正确文件有多容易?文件之间是否存在隐藏的依赖?一个**导航指针(navigation pointer)**会让事情更容易吗?适用时机:会话花了很长时间才找到某条信息。
- 自动化检查(Automated checks):是否有自动化检查能抓住 agent 犯下的错误?Lint、类型检查、测试、文件系统 linter?先读仓库自己的检查命令(它的
package.json/构建工具的lint/check脚本、它的 CI workflow),这样发现就是一个"已存在但没接线或悄悄坏掉的检查",而不是重复发明。一个没有任何护栏(guardrail)(没有 pre-commit 钩子、也没有 CI job 运行它的 lint/类型检查/测试命令)的仓库本身就是一个发现:一个不做 lint 的仓库是一个长期被错过的机会,而不是中性的默认状态。适用时机:agent 犯了一个自动化检查本可以抓住的错误,或仓库完全没有任何护栏。 - 编码标准(Coding standards):是否应该给 reviewer agent 一条新规则去执行?是否应该移除或澄清一条现有规则?先对违规进行分类:机械性(mechanical)违规(固定的语法模式、被禁用的 API、import 形态、文件位置规则)得到一个确定性检查,仅此而已:仓库自己 linter 里的一条自定义规则、一个新的 pre-commit 钩子、或一个新的 CI job,看仓库的语言和现有护栏哪个最便宜。默认构建检查,而不是写规则。把
CODING_STANDARDS.md留给真正的判断题(judgement calls)(跨文件一致性、"与周围风格匹配"、任何护栏永远无法替代的东西)。适用时机:reviewer agent 没能抓到一个错误。 - 全局 AGENTS.md:是否有任何引导指令应该移到编码标准(或自动化检查)里?适用时机:AGENTS.md 文件特别大——在仓库里或在用户全局范围内。
- 工具经济(Tool economy):agent 是否做了可以精简的昂贵工具调用?是否有任何自定义工具(CLI、MCP)特别浪费 token?适用时机:agent 做了一次昂贵的工具调用。
- 无操作(No-ops):寻找引导文件中不改变 agent 行为的指令。适用时机:引导文件又大又难管。
- 信息获取(Information access):寻找能增加 agent 信息获取能力的机会。把 dev server 日志 tee 出来、对第三方服务的只读访问。适用时机:agent 拿不到某条关键信息。
- 按严重程度排序,把这些候选呈现给用户。
参考
实现 vs 审查
记住,所有工作都经过两个阶段:实现和审查。实现 agent 承受的上下文压力最大。它们负责探索、写代码、调试失败。
审查 agent 的上下文压力最小——它收到的是一个 diff,无需探索。它通常不需要写代码或调试。
这意味着应该由审查 agent 负责执行编码标准,而不是实现 agent。
文件
你可以访问仓库中的几个文件:
CLAUDE.md/AGENTS.md:这些文件会被推送到任何在此仓库工作的 agent 的上下文窗口。应当极其节俭地使用它们,通常只用于指向其他文件的导航指针。CODING_STANDARDS.md:这个文件在审查时阅读,而不是实现时。如果标准文件超过 1000 行,就添加指向 docs 文件夹的导航指针。- Docs:把 docs 用作参考文件,由其他文件指向它们。写新文档之前先找已有的。
- Skills:把 skill 用作文档(因为它们的 description 会进入 agent 的上下文窗口),或作为用户调用的命令。遵循
writing-for-agentsskill 的建议。
04 同仓库更多 Skills
skills-link
管理 muscaestar/skills 仓库的 skill 安装。当用户想安装/卸载某个 skill、查看已装清单、把 skill 装到全局或某个项目、或问"这个 skill 装了没有"时使用。也用于向用户解释三层结构与全局/项目双范围安装策略。
★ 0
writing-shape
写作之 exploit:把原始素材塑形成一篇文章,逐段进行。
★ 0
writing-fragments
写作之 explore:开采原始碎片,还没有结构。
★ 0
writing-for-agents
为 agents 编写文档。在创建或编辑技能,或修改 AGENTS.md 或 CLAUDE.md 时使用。
★ 0
writing-beats
写作之 exploit;把原始素材组装成一段由节拍(beat)构成的旅程,在每个节拍倚赖某个术语之前先把它落地。
★ 0
wizard
生成一个交互式 bash 向导,引导人类完成只有他们才能执行的步骤。当需要配置基础设施、设置凭据或 CI secret、摸索不熟悉的第三方仪表盘,或执行一次性的迁移或切换时使用。不要为 agent 自己能执行的步骤调用本技能。
★ 0