SuperAPI AI 工具集

durable-docs-update

编程与开发

查看项目

更新于 10-16 03:47

技能介绍

用途:在编码工作后清理变更文件中的注释,并把真正有价值的事实同步到对应的持久文档中。整个流程按 WORTH → PLACE → SHAPE 三步判断执行,核心两个判断为:该注释是否应存在(否则删除),该事实是否属于当前指引(否则丢弃)。该技能由调用方以内联方式调用,不作为叶子子代理。

主要能力:

  1. 范围解析,支持三种模式:会话模式(依据本代理创建或编辑的文件历史)、提交区间模式(基于 git diff --name-only A..B 与 git diff A..B)、调用方指定模式(给定文件列表与 git diff -- <files>),且明确不得用 git status 推导范围。
  2. 按范围文件数分档限制子代理数量:1–3 个小规模最多 1 个,4–8 个中等最多 2 个,9+ 个大规模最多 3 个;按最近父级 AGENTS.md 分组,每个文件只归一个发现子代理。
  3. 发现、判断与放置:子代理加载 vet-fact 和 place-fact,检查文件注释、祖先 AGENTS.md、.claude/rules/ 路径规则、按路由匹配的任务文档等;候选来自注释、Discovery 条目、锁定的 spec 决策以及直接命名受影响行为的现有指引。
  4. 合并、门槛与分配:对事实与目标去重,保留最高置信度;置信度 ≥ 0.80 才接受,低于则直接丢弃;目标为 meta/DESIGN.md 时调用 map-design-language,其余按目标文件分配应用子代理。
  5. 应用与一致性检查:应用子代理加载 compress-file、tighten-instruction、structure-prose,返回每文件一行、注释统计与删除详情;一致性子代理加载 check-coherence。

必要用法:调用方(如编排器)传入 discoveries、context、spec 等可选输入,并按其模式提供范围;各子代理的 Git 读写必须限定在分配的文件内,禁止执行 git stash、git checkout -- .、git reset 等整树变更操作;读取基线用 git show HEAD:<path>。

适用场景与限制:适用于编码后需要同步持久指引、清理过时或错误注释的仓库维护工作。限制包括:不做整仓库扫描,只处理变更范围内及直接相关的指引;不改动无关注释(如测试分隔符、历史记录);排除活动状态文档、带日期的调查、会话日志、交接、流程文档及 skills/commands 目录;只有涉及用户界面且满足刷新触发条件时才提议刷新 DESIGN.md;需保留 D-NNN-XX 或 AC-NNN-XX 标识,去掉任务号、波次号与 F-NNN-XX,且不返回候选文本之外的文件内容。

收费、价格与支持平台等资料暂未提供。