SuperAPI AI 工具集

flow-next-audit

通用与其它

查看项目

更新于 10-15 21:53

技能介绍

flow-next-audit 用于审计 .flow/memory/ 中的记忆条目,依据当前代码库判断每条记忆是保留(Keep)、更新(Update)、合并(Consolidate)、替换(Replace)还是删除(Delete)。它由宿主 agent(如 Claude Code、Codex、Droid)直接执行:遍历 .flow/memory/,读取每条条目,用 Read/Grep/Glob/git 验证其中引用的文件、符号与模块,再给出带证据和置信度的建议。

主要能力包括:发现与分诊记忆条目并按模块或类别分组;扫描 GLOSSARY.md 词条,检查代码引用,零命中者标记为 stale,别名出现在代码中则报告 alias-creep;对条目进行跨文档重叠、取代与矛盾分析;知识/决策类条目用“促使该选择的约束是否仍然成立?”来判断,替换时采用两步取代(写新条目并把旧条目标记为 decision_status: superseded,不删除旧文件);输出完整审计报告并可提交。

用法:通过 /flow-next:audit 触发,参数中可加入 mode:autofix 进入自动修复模式。默认交互模式会通过提问工具逐个确认模糊判定;autofix 模式不提问,直接应用安全操作,将模糊项标记为 stale。flowctl 是内置的,不全局安装,需使用 FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl"。它只提供 memory mark-stale、memory mark-fresh、memory search --status 等持久化命令,glossary 相关操作需用 Edit 工具。

限制包括:不审计旧式扁平文件(如 pitfalls.md、conventions.md、decisions.md),也不审计 _audit/、_review/ 等下划线目录;不主动静默删除,删除仅限代码与问题域都已消失的情况;不对被取代的决策条目执行 git rm;不自动重命名代码;不在交互模式下未经用户确认就提交;不使用 context: fork;替换子任务需串行执行。