SuperAPI AI 工具集

refresh-agent-context

编程与开发

查看项目

更新于 10-16 05:57

技能介绍

用途

该技能用于在 Turborepo 持续演进的过程中,保持仓库对编码智能体(coding agents)的可理解性。其核心目标是检测实际工作区结构与面向智能体的文档之间的偏差(drift),然后更新最小集合的文档,恢复一条快速进入正确应用或包的路径。

主要能力

  • 生成当前仓库清单:运行内置脚本 node skills/refresh-agent-context/scripts/workspace_inventory.mjs,输出应用与包工作区、包名、从 package.json 推断的开发端口、从 next.config.ts 推断的资源前缀和 NEXT_PUBLIC_APP_NAME,以及每个应用是否存在 AGENTS.md、README.md、CLAUDE.md。
  • 审计文档覆盖:检查缺失的根级 AGENTS.md、应用缺失 AGENTS.md、存在 Claude 专属引导时 CLAUDE.md 缺失或过时、空或仅有占位内容的 AGENTS.md、README 或 CLAUDE.md 中关于应用名、端口、包名或 CMS/框架归属的过时条目、对重要共享包(如 packages/i18n、packages/ui-chrome、packages/ecosystem-data)的引用缺失,以及当前文档中不明显的路由归属。
  • 最小化修补文档:优先更新根级 AGENTS.md、根级 README.md、根级或应用级 CLAUDE.md、应用级 apps/*/AGENTS.md,仅在能实质性帮助路由归属或共享代码发现时才更新包文档。
  • 对照源文件验证:在最终确定前,从 package.json 验证包名,从工作区脚本验证端口,从 next.config.ts 验证资源前缀、重写和 NEXT_PUBLIC_APP_NAME,从实际的 content/、src/ 或包布局验证内容归属。
  • 报告审计结果:总结哪些内容过时或缺失、更新了哪些文档、哪些内容无法自动验证。

使用方式

从仓库根目录运行清单脚本,将其输出作为当前 monorepo 形态的基线快照。然后按工作流执行:构建当前仓库清单、审计文档覆盖、修补最小文档集、对照源文件验证、报告审计。文档应保持简短且可操作,优先使用表格呈现工作区映射、使用项目符号列出注意事项;当 AGENTS.md、CLAUDE.md 和根级引导文档描述相同工作区事实时,应保持它们一致;当简短指针足够时,不要重复冗长的应用文档;如果无需更改,应说明并附上审计发现。

适用场景

  • 新增应用后刷新仓库的智能体文档
  • 审计 Turborepo 并更新 AGENTS.md 文件
  • 更改端口和路由归属后重建智能体上下文
  • 运行周期性的智能体参考文档刷新

限制

资料未提供该技能的具体安装方式、依赖要求、支持的 Turborepo 版本范围、脚本的完整参数说明,以及除上述文件类型外的其他文档格式支持情况。