用途:up-drift(/up-docs:drift)用于在基础设施与 Wiki 之间做全面的文档漂移分析,通过调度 up-docs-audit-drift 子代理(Sonnet)执行。设计上为只读:审计者只输出发现,是否再调用 propagators 去修复由用户决定。
用法:命令为 /up-docs:drift [collection-name]。给出 collection 名称时,分析范围限定到该 Outline collection;否则分析全部 collections。
架构:审计子代理在自身隔离上下文中运行完整的四阶段漂移流程:基础设施到 Wiki 的同步(针对实时状态执行 SSH/pct/curl)、Wiki 内部一致性(交叉引用映射)、链接完整性与增强、Notion 相关性审查。阶段机制相关的脚本(scripts/convergence-tracker.sh、scripts/server-inspect.sh、scripts/link-audit.sh)仍位于本插件内,由子代理的 Bash 工具直接调用。
工作流:先校验 Python 3 是否可用,因为所有辅助脚本都依赖它: command -v python3 >/dev/null 2>&1 || { echo "ERROR: python3 not found in PATH — install python3 and retry."; exit 1; } bash ${CLAUDE_PLUGIN_ROOT}/scripts/context-gather.sh bash ${CLAUDE_PLUGIN_ROOT}/scripts/convergence-tracker.sh init 随后结合会话历史,按 ${CLAUDE_PLUGIN_ROOT}/templates/session-change-summary.md 的格式构建会话变更摘要,作为审计扫描的起点并扩展到可能受连带影响的基础设施。接着通过 Agent 工具以 subagent_type: "up-docs:up-docs-audit-drift" 调度子代理(插件命名空间前缀必需),提示中放入会话变更摘要与 collection 范围参数。子代理返回 JSON findings 块(规范产物)与 markdown 发现表格,两者都要在最终输出中呈现;若含 ⚠ ESCALATION RECOMMENDED 块需原样保留。最后用 AskUserQuestion 提供有界选择:以发现作为新会话变更摘要重新调用 propagators(以 Haiku 成本修复)、若建议升级则用 Opus 重跑审计、或将发现作为参考并退出;不要自动执行以上任一项。
限制与说明:本技能不再直接运行 SSH/pct/curl,改由子代理执行。收敛与振荡检测位于 scripts/convergence-tracker.sh,默认状态文件路径为 ${TMPDIR:-/tmp}/up-docs-tracker-${CLAUDE_CODE_SESSION_ID:-default}.json,以便一次漂移会话中 6 次以上独立调用共享状态;可用 UP_DOCS_TRACKER_STATE 覆盖,供测试或非会话使用。发现仅为建议性:审计者对 Outline 或 Notion 没有写入工具,修复需在用户明确同意后经 propagators 在后续轮次完成。资料未提供具体收费、平台支持范围等信息。