Community编程与开发github.com

Wanbicoi/agent-config

对编码会话进行回顾,提出改善开发环境与工作流程的可行性建议。

agent-config 是什么?

该技能用于对一次编码会话进行系统性回顾,分析并识别可改进的环节,从而提升后续编程代理的运行效率与质量。它要求代理首先按照写作风格指南获取参考,然后读取指定会话的日志(默认当前会话),重点在导航、自动化检查、编码标准、全局配置文件、工具经济性、无操作指令和信息访问七个维度中寻找改进点。技能特别强调区分“实现”与“审查”两个阶段,主张将编码标准检查交由审查代理承担,以减轻实现代理的上下文压力。同时,它提供了对 `CLAUDE.md`、`CODING_STANDARDS.md` 和 Docs 等关键文件的使用建议,并推荐优先在现有工具链中构建确定性检查,而非仅添加人工规则。该技能适用于作为代码代理(如 Claude Code、Cursor 等)的回调或后处理工具,帮助团队持续优化仓库配置及代理行为。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Wanbicoi/agent-config/tree/HEAD/skills/retro

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

用户要求进行一次回顾。你将提出改进编码代理运行环境的建议,以优化未来的执行过程。

步骤

  1. 调用 writing-for-agents 技能的 Skill 工具获取写作风格指南。

  2. 读取用户指定的会话的主要日志来源。这可能意味着在本机搜索会话日志。如果用户未指定会话,则默认使用当前会话。

  3. 从以下类别中寻找可改进项。

  • 导航:代理找到正确文件的难易程度如何?文件间是否存在隐藏的依赖关系?添加一个导航指针是否会更容易?适用场景:会话花费了很长时间才找到某个信息。
  • 自动化检查:是否存在可以捕获代理所犯错误的自动化检查?如 linting、类型检查、测试、文件系统 linter?首先阅读仓库自身的检查命令(其 package.json/构建工具中的 lint/check 脚本、CI 工作流),因此如果一个已经存在但未连接或静默失效的检查才是发现,而不是重新发明轮子。一个没有护栏(没有 pre-commit 钩子,没有运行 lint/类型检查/测试命令的 CI 作业)的仓库本身就是一个发现:未 lint 的仓库是一个长期错失的机会,而不是中性的默认状态。适用场景:代理犯了一个本可以通过自动化检查捕获的错误,或者仓库完全没有护栏。
  • 编码标准:审查代理是否应被赋予一条新的规则来执行?现有规则是否应被移除或澄清?首先对违规进行分类:机械性违规(固定的语法模式、禁止使用的 API、导入形状、文件位置规则)应获得确定性检查,无需多言:在仓库自身的 linter 中添加自定义规则、新的 pre-commit 钩子或新的 CI 作业,根据仓库语言和现有护栏选择最经济的方式。默认优先构建检查而非编写规则。将 CODING_STANDARDS.md 留给真正的判断性问题(跨文件一致性、“与周围风格匹配”、任何护栏永远无法替代的方面)。适用场景:审查代理未能捕获某个错误。
  • 全局 AGENTS.md:是否存在应该移至编码标准(或自动化检查)中的引导指令?适用场景:仓库或用户全局作用域中的 AGENTS.md 文件特别庞大。
  • 工具经济性:代理是否调用了昂贵但可以简化的工具?是否存在特别消耗令牌的自定义工具(CLI、MCP)?适用场景:代理调用了昂贵的工具。
  • 无操作指令:查找引导文件中不改变代理行为的指令。适用场景:引导文件庞大且难以管理。
  • 信息访问:寻找增加代理信息访问的机会。例如:打开开发服务器日志,以只读方式访问第三方服务。适用场景:代理未能获取关键信息。
  1. 按严重程度向用户展示这些可改进项。

参考

实现 vs 审查

请记住,所有工作都经历两个阶段:实现和审查。实现代理承受最大的上下文压力。他们负责探索、编写代码和调试失败。

审查代理的上下文压力最小——它接收一个 diff,因此无需探索。它通常不需要编写代码或调试。

这意味着审查代理应负责施加编码标准,而不是实现代理。

文件

您有权访问仓库中的几个文件:

  • CLAUDE.md/AGENTS.md:这些文件会被推送到在该仓库中工作的任何代理的上下文窗口中。应极其谨慎地使用它们,通常仅用于指向其他文件的导航指针。
  • CODING_STANDARDS.md:此文件在审查期间读取,而非实现期间。如果标准文件长度超过 1000 行,请在 Docs 文件夹中添加指向文档的导航指针。
  • Docs:将文档用作参考文件,由其他文件指向。在编写新文档之前,先查找现有文档。
  • Skills:技能可用于文档(因为其描述会被放入代理的上下文窗口),或用于用户调用的命令。遵循 writing-for-agents 技能中的建议。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能