SuperAPI AI 工具集

index-refresh

写作与研究

查看项目

更新于 10-16 07:51

技能介绍

Index Refresh 是一个面向 LLM Wiki 的索引维护技能,用于在收到索引刷新请求时,保持 wiki/index.md 的准确性与可浏览性。索引是维护者导航的第一入口,其质量直接影响后续每次操作的成本。

用途 当出现 operationType 为 "index" 的操作问题(或标题为 index-refresh 的例行任务)时使用本技能。它只刷新操作问题指定的目标空间,除非问题明确说明这是一次多空间扫描。

输入 一个带有 operationType: "index" 的操作问题(或 index-refresh 例行任务标题)。操作问题中的目标 wikiId、spaceSlug 和空间根目录。除非问题明确说明是多空间扫描,否则只刷新该空间。

工作流程

  1. 读取目标空间当前的 wiki/index.md。
  2. 遍历目标空间的 wiki/ 目录。wiki/projects/<slug>/standup.md 是持久页面 wiki/projects/<slug>/index.md 的当前状态伴随文件,只作为链接附加到对应项目条目下进行索引。按类别遍历 wiki/(sources/、projects/、entities/、concepts/、synthesis/,以及 wiki schema 添加的任何自定义子目录)。
  3. 读取目标空间 wiki/log.md 最近约 50 条记录,找出已创建或大幅修改但从未进入索引的页面。
  4. 按类别生成排序条目,格式为:- [[<path>]] — <一行摘要>。摘要取自页面第一段或标题的一句事实性描述。索引中不写状态、不写日期戳,这些属于页面本身或日志。
  5. 删除页面已不存在的条目,并在日志中记录删除。
  6. 为磁盘上存在但索引中缺失的页面添加条目。跳过 wiki/log.md 和 wiki/index.md 本身。对于没有对应持久项目页面的独立 wiki/projects/<slug>/standup.md,将其添加到 Projects 下,并标记以便后续提炼为持久页面。
  7. 以编辑视角撰写项目条目。Projects 部分应按项目的概念和目的组织工作,而不是按 issue id、日期、状态、UUID 或来源元数据。任务标识符仅作为辅助证据链接。
  8. 保留自定义类别。如果 wiki 添加了如 wiki/papers/ 或 wiki/runbooks/,保留其索引分区,不要压缩为默认的五个类别。
  9. 追加带计数的日志条目:## [YYYY-MM-DD] index-refresh | added=N removed=M,并附上操作问题标识。如果索引本就准确,日志条目写 added=0 removed=0,仍需写入,以便未来审计能看到本次运行。

本技能不做的事 不修改页面内容。不解决矛盾、不修复断链、不填补概念空白,这些留给下一次 wiki-lint 运行。不撰写页面本身不支持的新摘要;如果页面缺少可概括的清晰首段,则标记给 wiki-lint。

语气 索引条目每页一行事实性描述,使用现在时。wiki/index.md 中不使用表情符号、状态或日期,日期只存在于日志中。

验证 关闭操作问题前需确认:wiki/index.md 与 wiki/ 实际内容一致,无缺失页面、无悬空条目;项目条目在存在 standup 时包含当前 wiki/projects/<slug>/standup.md 链接;每行索引格式为 - [[path]] — <summary>;自定义类别分区被保留;wiki/log.md 中有带计数的 index-refresh 条目(即使计数为零);未修改任何页面正文,未修改 raw/ 下的任何文件。

工具 使用 wiki_search、wiki_read_page、wiki_write_page(仅用于 wiki/index.md 和 wiki/log.md)。始终包含操作问题的 wikiId 和 spaceSlug。