Communitygithub.com

zhaidewei/保留或清理

保留、修复、归档或清除——一项以证据为先的AI Agent技能

保留或清理 是什么?

该技能旨在帮助开发者或AI Agent用户对单一、明确定界的资产进行审计,并基于证据得出“保留、修复/替换、归档、删除或暂停”的处置结论。它强调证据导向的决策,防止资产审计演变成全仓库的去重或规范化工件。技能支持任何可通过清单、代码、配置或运行状态表征的资产,适用于Claude Code、Cursor、Codex等以指令或MCP协议运行的Agent平台。工作流程包括:界定资产范围、只读盘点实际消费者与依赖、测试删除反事实(即观察哪些行为会恶化)、分类角色(真实来源、投影、适配器等),并最终选择一个处置方案。对于“删除”或“归档”等操作,技能要求先确认恢复方法或保留义务,且审计本身不授权执行。当证据不足时,应暂停并指明所需的最小下一步检查。这帮助Agent避免草率决策,将不确定性与不可逆损失降至最低。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add zhaidewei/keep-or-sweep

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

保留或清理 是做什么的?

审计一个明确界定的资产。不要将此任务转变为全仓库的重复项清理或规范化工件查找。

工作流程

  1. 界定资产。 明确目标资产、所有者或权限、允许的操作以及影响边界。如果请求包含多个独立资产,则为此审计选择一个明确目标,并将其他资产列为“超出范围”。不要在同一次审计中继续处理列表中的其余项目。
  2. 只读盘点。 查找实际消费者、调用者、触发器、依赖项、输入、输出、契约、生成的副本、历史记录、保留义务以及运行时使用情况。搜索名称和行为;动态使用和不可用的权限仍属未知。
  3. 测试删除反事实。 说明如果资产消失,哪些可观察的用户或Agent行为会恶化。名称匹配或形状相似并不能证明冗余。
  4. 分类其角色。 真实来源、投影和适配器是角色,而非最终判定。对于投影,需验证其消费者特定价值、与来源的一致性、再生或同步方式,以及维护机制(包括所有者、触发器、漂移检测和修复路径)。
  5. 恰好选择一个处置方案。
    • 保留: 有证据表明其价值且维护机制可信。
    • 修复或替换: 有证据表明其用户,但当前机制不可靠。
    • 归档: 不存在活跃使用,但存在法律、历史、审计或合同规定的保留义务。
    • 删除: 无可观察行为会恶化,且无保留义务适用。此为推荐,不授权执行。
    • 暂停: 证据、权限、授权、可恢复性或不可逆风险分析不足。
  6. 仅在权限范围内执行。 只读审计绝不意味着允许删除、覆盖、变更远程状态或进行不可逆更改。在删除之前,需指明恢复方法。删除之后,需验证预期消费者是否存在,并报告任何仍未证明的情况。

决策树

flowchart TD
    A["界定一个资产<br/>并只读盘点"] --> B{"证据是否充分?"}
    B -- "否" --> P["暂停并指明<br/>缺失的证据"]
    B -- "是" --> C{"删除是否会恶化<br/>可观察行为?"}
    C -- "未知" --> P
    C -- "否" --> D{"存在保留义务?"}
    D -- "是" --> R["归档"]
    D -- "否" --> X["推荐删除"]
    C -- "是" --> F{"维护机制<br/>是否可信?"}
    F -- "是" --> K["保留"]
    F -- "否" --> N["修复或替换"]

未知的消费者、动态调用、缺失的访问权限和缺失的证据并不意味着资产未被使用。当不确定时,暂停并找出能够改变处置结果的最小下一步检查。

相关技能