SuperAPI AI 工具集

manage-knowledge-audit

办公与效率

查看项目

更新于 10-15 20:11

技能介绍

用途:对 spec / knowhow / artifact 三类知识存储做语义层审查与淘汰,与 harvest --prune 的物理 GC 互补。闭环流程为 harvest 写入、audit 审查、三态淘汰;删除未抽取的 artifact 前反向触发 harvest 抢救。\n\n主要能力:覆盖 8 大场景类、28 子场景(显性/隐性矛盾、失效老化、元数据质量、Maestro 特化、时间线产物 T1-T6、knowhow 漂移、artifact 残留);按 P0/P1/P2 输出 finding;建立时间线索引(mtime 与 session/milestone 状态对应)。\n\n使用方式:必选 scope 为 spec | knowhow | artifact | all。删除策略默认 --interactive(三态面板逐项决策);非交互模式有 --mark(仅打标)、--delete(软删到 .trash/)、--purge(物理擦除,仅 artifact 且需双重确认)。完成后写入 .workflow/.knowledge-audit/audit-report-{date}.md 与 audit-log.jsonl。其他 flag、扫描路径、Stage 步骤、检测算法见 workflow knowledge-audit.md。\n\n关键约束:变更前必须备份到 .workflow/.trash/knowledge-audit-{timestamp}/,备份失败禁止继续;文本存储优先 deprecate(注入 status="deprecated")而非删除;--purge 仅限 artifact 且需二次确认并输入 artifact id;删除未抽取 artifact 前强制提示先跑 /manage-harvest。\n\n错误码:E001 .workflow/ 未初始化需先跑 /maestro-init;E002 scope 缺失或非法;E003 --purge 与 --dry-run 同用;E004 --purge 用于非 artifact 范围;E005 备份失败。警告包括 W001 冲突后选择 keep、W002 待删 artifact 无 harvest-log 记录、W003 循环 supersedes 链、W004 检测耗时超 120s、W005 LLM detector 不可用降级。\n\n适用场景:milestone 结束等周期巡检可跑 --scope all --report。限制:未提供具体价格、平台要求与完整检测算法细节,需查阅 workflow knowledge-audit.md。