Kweaver-dip archive-protocol

全局归档协议。只要任务需要写入任何文件(含 PLAN.md、报告、JSON 等归档物),必须按本技能执行 Session→ARCHIVE_ID、TIMESTAMP、双轨路径(根段须为 archives/)、回读校验与状态回执;WebUI 的 archive_grid 必须用 Markdown 中语言标识为 json 的围栏代码块输出。

install
source · Clone the upstream repo
git clone https://github.com/kweaver-ai/kweaver-dip
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/kweaver-ai/kweaver-dip "$T" && mkdir -p ~/.claude/skills && cp -r "$T/deploy/openclaw-extensions/dip/skills/archive-protocol" ~/.claude/skills/kweaver-ai-kweaver-dip-archive-protocol && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/kweaver-ai/kweaver-dip "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/deploy/openclaw-extensions/dip/skills/archive-protocol" ~/.openclaw/skills/kweaver-ai-kweaver-dip-archive-protocol && rm -rf "$T"
manifest: deploy/openclaw-extensions/dip/skills/archive-protocol/SKILL.md
source content

全局归档协议

只要当前任务需要写入任何文件,就必须执行本协议。

归档物包括但不限于:

PLAN.md
report.md
summary.md
result.json
notes.md

优先级:本协议高于任何业务协议。定时计划类任务在

schedule-plan
技能中约定,且只能调用本归档规则,不能覆盖。

【身份文件】

若任务需要人格/身份设定,只认:

  • SOUL.md
  • IDENTITY.md

未确认可读或已注入上下文前,不得声称「已成功读取」。

归档协议 (Archive Protocol)

【核心规则:必须全量归档】

所有生成的成果性内容(无论是单个文件还是整个目录/文件夹),在任务完成后必须彻底搬移(Move)至归档区。

工作区(Workspace)仅作为临时加工场,任务结束后的合规状态是:工作区不留任何生成物,全部进入

archives/

【归档路径规则】

路径执行双轨制,严禁混淆,并且只能

archive
工具写入。注意:归档操作会将文件或目录从工作区物理搬移(Move)至归档区,原位置将不再存在。

  1. 计划文件(PLAN.md 专属):工具参数
    {"kind":"plan","sourcePath":"PLAN.md"}
    。归档后,如需修改计划,应直接编辑
    archives/{ARCHIVE_ID}/PLAN.md
  2. 普通归档物(单个文件或整个目录):工具参数
    {"kind":"file","sourcePath":"result_dir"}
    。支持归档单个文件或包含多个文件的目录。

【目录归档模式】

当你的输出包含多个文件(如前端项目、代码包、多份分析报告)时,必须执行以下流程

  1. 在工作区创建一个专用文件夹(如
    output/
    )。
  2. 将所有相关文件放入该文件夹。
  3. 调用
    archive
    工具对整个文件夹进行归档
    sourcePath
    指向文件夹路径)。
  4. 归档成功后,整个文件夹及其内容将移入
    archives/{ARCHIVE_ID}/{TIMESTAMP}/

【写入后强制校验】

任何归档文件写入后,必须立即回读校验。未完成校验前,不得声称「已成功归档」。调度

archive
工具会在写入后自动回读并输出状态卡片。

输出

请在最终输出的结尾,把archive工具的输出卡片也输出出来。必须以markdown的json代码块输出,输出的json内容为archive工具的返回内容。除archive工具外的其他工具的输出不要在结尾处输出。

【工具执行指引】

所有归档物生成都必须通过

archive
工具 完成;禁止直接写
archives/
目录。推荐流程:

  1. 准备源文件:在工作区临时目录编写内容。
  2. 调用工具(工具会自动解析 session,生成
    TIMESTAMP
    ):
    • 单个文件归档
      {
        "name": "archive",
        "arguments": {
          "kind": "file",
          "sourcePath": "result.json"
        }
      }
      
    • 整个目录归档(推荐用于多文件结果)
      {
        "name": "archive",
        "arguments": {
          "kind": "file",
          "sourcePath": "my_results_folder"
        }
      }
      
  3. 后续操作:归档成功后,工作区原文件/目录已删除。若需再次查看或编辑,必须使用工具返回的 JSON 卡片中的
    subpath
    archive_root
    拼接出的完整路径
    访问归档区文件。
  4. 异常处理:工具返回错误提示(如
    Archive blocked
    )时须立刻停止归档流程,引用错误原因告知用户并等待下一步指示;禁止在失败后自行补写文件或回执。