SuperAPI AI 工具集

update-overview

编程与开发

查看项目

更新于 10-16 09:38

技能介绍

用途

update-overview 是一个用于盘点项目 Codex 配置资产的技能。它扫描当前项目中的指令、技能、智能体、规则以及配置键名,并据此生成或更新一份本地概览文档。整个过程不访问运行时环境、账户信息或敏感数据。

主要能力

  • 解析中英文提示词,判断模式与目标:单一明确的 status、show、update 等词优先;show/list/check 及「покажи/список/проверь」解析为只读状态;update/refresh 及「обнови/освежи」解析为更新;空输入默认执行更新。
  • 从自然语言中提取路径,对影响结果的歧义进行澄清。
  • 在执行前输出一份英文计划,包含模式、项目范围、输出路径与预期结果。
  • 盘点范围限于当前项目的 AGENTS.md、.codex/rules/、.codex/skills/、.codex/agents/、.agents/skills/ 以及明确指定的项目 Codex 配置文件。
  • 通过聚焦的 rg --files 进行发现,记录路径、格式、用途、符号链接目标与缺失引用。
  • 仅跟随指向受跟踪仓库指令/参考来源的链接;对外部目标只记录而不读取。
  • 规则需要显式指令引用;发现别名不代表插件被激活。

使用方式

  • status 模式:返回发现结果,不写入任何文件。
  • update 模式:写入请求的项目本地文档;若未指定,则写入 .codex/reports/<YYYYMMDD-HHMMSS_codex-overview>/overview.md。
  • 更新已有概览时,保留无关内容。
  • 输出内容包含指令/规则关系、技能与智能体、配置键清单、来源路径、检查日期与缺口;仅对允许的路径使用紧凑树形展示。
  • 最后汇总变更的清单与写入路径。

适用场景

适用于需要了解当前项目 Codex 配置全貌、维护项目本地概览文档、或在不触碰敏感数据的前提下审计项目指令与规则结构的场景。

限制

  • 对 JSON/TOML 配置只报告结构键名,绝不报告值。
  • 不导出配置内容或包含源码行的解析器诊断信息。
  • 不读取 .env、凭据、认证、会话、历史、数据库、缓存、shell 快照、密钥环境变量或全局运行时目录。
  • 不扫描或测量被排除的目录。
  • 不同步到全局配置或 .claude/。
  • 不将 Claude 运行时扫描、配置转储、插件命令或全局同步引入此工作流。
  • 以当前受跟踪清单为证据,区分缺失引用与不可用的外部来源。