SuperAPI AI 工具集

artifact-resurfacing

办公与效率

查看项目

更新于 10-15 10:44

技能介绍

用途

Artifact Resurfacing 用于处理多会话、多作用域、多仓库工作流中的“熵”:会话命名了产物,产物随后移动,会话结束,记忆保留了旧名称,下一次会话又重新发现同样的漂移。该技能把这种漂移摆到桌面上,浮现被埋藏的产物——过期引用、缺失的被引用文件、孤立计划、指向已移动路径的跨作用域记忆条目——以提案形式打磨,并固化经验,使下一次会话不必重新发现同样的漂移。

主要能力

该技能围绕四阶段协议展开:

阶段 1 — 检测(Detect):枚举目标域的引用面。对目标 CLAUDE.md 或 MEMORY.md,提取所有文件路径、函数/脚本标识符、议题/账本 ID、外部引用、计划文件名。运行引用审计脚本 bash scripts/audit-citations.sh <path-to-CLAUDE.md>,输出每条引用的 JSONL 记录 {cited, kind, exists, found_at, status}。运行孤立计划扫描 bash scripts/find-orphan-plans.sh [glob],默认 glob 为 ~/.claude/plans/*.md,输出 {path, mtime, has_done_ref, has_irf_ref, has_delivered_research_marker}。在分类前向用户展示四列发现表:artifact、cited-at、status、candidate-action。

阶段 2 — 分类(Classify):为每个发现分配一个类别:Present(无需操作)、Stale-citation(产物存在但引用指向错误路径)、Missing-but-probably-never-written(引用超前于未写产物)、Missing-but-lost(产物创建历史存在但产物本身丢失)、Orphan-plan(传递给 closeout 的分类器)。对于模糊分类,向指挥者展示并停止。

阶段 3 — 打磨(Polish,只提议不应用):为每个已分类发现生成打磨产物,绝不直接写入宪法性文件。对过期引用运行 python3 scripts/propose-citation-fix.py --file <path> --stale-path <wrong-path> --canonical-path <correct-path>,输出统一 diff 到 stdout,由指挥者审查后应用或拒绝。对“可能从未写过”的缺失,生成一行注释 diff。对“已丢失”的缺失,先发出深度搜索命令集,若搜索命中则重新分类为过期引用,若零命中则重新分类为可能从未写过。对孤立计划,将计划路径交给 closeout 并请求分类。

阶段 4 — 固化(Codify,未来修复):为每个已打磨发现向受影响仓库根目录的 polish-log.md 追加条目,包含日期、摘要、产物、类别、发现、操作、授权、固化。然后检查复合模式:同一过期引用出现在 ≥2 个作用域、同一孤立计划类别出现在 ≥5 个计划、跨作用域记忆漂移。为每个未解决发现发出一个 IRF 行提案。

使用方式

该技能通过自然语言触发,例如:“Resurface buried artifacts in <domain>”、“Find stale citations in this CLAUDE.md”、“Reconcile memory drift between scopes”、“Audit this domain for orphans”、“Polish referenced-but-missing files”、“Future-fix this so it doesn't drift again”。也可在 closeout 浮现 ≥3 个根因为记忆与磁盘漂移的后续项、MEMORY.md 回溯标记 ≥1 个过期路径引用、或查找 CLAUDE.md 引用路径返回零结果时使用。

适用场景

适用于多会话、多作用域、多仓库工作流中,记忆声明、CLAUDE.md 引用与磁盘实际状态之间出现漂移的场景。与 closeout(浮现)和 consolidate-memory(修剪)配对使用。

限制

该技能明确不做以下事情:未经同一会话指挥者授权,不编辑 CLAUDE.md、MEMORY.md、governance-rules.json、registry-v2.json 或任何 seed.yaml;不分配 DONE-NNN 或 IRF-XXX-NNN 关闭标签;不将计划移动到 ~/.claude/plans/abandoned/;不从上下文自动重建缺失产物;不作为后台守护进程、cron 或 LaunchAgent 运行;不遍历未被要求遍历的域;不批量关闭孤立计划。发现不等于修复:技能负责发现和提议,指挥者负责应用。