SuperAPI AI 工具集

audit-memories

智能体与模型

查看项目

更新于 10-16 00:24

技能介绍

用途:审计并清理当前项目中面向智能体的 Markdown 文件。仅在用户显式调用 $audit-memories 或 /audit-memories 时执行;OpenCode 命令声明用户调用了 /audit-memories 也算满足条件。默认动作是 audit;clean 先审计,再执行有依据的本地清理。

范围:项目根目录取自 $PWD,不切换检出,不读取或修改 ~/.codex/memories。只分类面向智能体的 Markdown:AGENTS.md、CLAUDE.md、GEMINI.md、.agents//*.md、.claude//.md、.cursor/**/.{md,mdc}、.github/copilot-instructions.md、.github/instructions//*.md、skills//SKILL.md、.agents/skills/**。产品文档、README、changelog 与公开规范仅作为真实性证据。

主要能力:先读取最近的 AGENTS.md、CLAUDE.md 与仓库规则;记录前后 git status --short;不检查密钥值;不使用 rm -rf,删除需经批准后放入回收站;文本修改使用 apply_patch;未实际核验的提供方/运行时声明标记为 NOT VERIFIED;不因文件老旧而删除指令、安全、迁移、事故或破坏性防护类文件。

使用方式:审计运行 python3 ~/.agents/skills/audit-memories/scripts/inventory_project_markdown.py --root "$PWD" --format json,字节账本须 visited == eligible,然后读取每个合格文件;超过 30 个文件时分 10–20 个互不重叠批次,每行一个路径,并集等于清单。分类前加载 cleanup-rubric.md。为每个文件给出 KEEP、UPDATE、MERGE、ARCHIVE、DELETE 或 VERIFY 结论,并将重要声明标记为 VERIFIED、CONTRADICTED、NOT VERIFIED、HISTORICAL 或 OPINION。返回根目录、git 边界、计数、预计总量、每文件一行、带行证据的矛盾、合并簇、失效链接、受保护文件与 NOT VERIFIED 声明;除非被要求否则不写报告文件。

清理阶段:复用仍有效且完整的审计,否则重新审计;复核哈希与 git 状态后执行结论。工作区有未提交改动时,跳过重叠的用户改动(BLOCKED),在无冲突文件上继续。修改后重跑清单与链接检查、搜索被移除或重命名的路径、执行相称的仓库校验,确认 diff 仅涉及 Markdown。除非被要求,不提交或推送。