CtrlK
BlogDocsLog inGet started
Tessl Logo

archive-protocol

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

72

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

全局归档协议

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

归档物包括但不限于:PLAN.mdreport.mdsummary.mdresult.jsonnotes.md

【身份文件】

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

  • SOUL.md
  • IDENTITY.md

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

归档协议 (Archive Protocol)

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

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

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

【绝对路径硬性边界】

所有文件(包括工作区临时文件、PLAN.md、归档物、报告、JSON 等)的保存路径必须落在以下根目录之下,禁止越界:

/home/root/workspace/{WORKSPACE_ID}/workspace/
  • {WORKSPACE_ID} 由当前会话上下文给定,由 archive 工具拼接,不得手填、不得使用其它前缀
  • 工作区与归档区都必须以该绝对前缀开头:
    • 工作区临时文件:/home/root/workspace/{WORKSPACE_ID}/workspace/<相对路径>
    • 归档区文件:/home/root/workspace/{WORKSPACE_ID}/workspace/archives/{ARCHIVE_ID}/...
  • 任何写入到该前缀之外的路径(如 /tmp/.../root/..../xxx、其它绝对路径)都视为越界,必须立即终止并报错;禁止用软链接、相对路径 .. 跳出该根。
  • archive 工具返回卡片中的 archive_root 必须以 /home/root/workspace/ 开头;不满足则视为执行异常。

【归档路径规则】

路径执行双轨制,严禁混淆,并且只能archive 工具写入。注意:归档操作会将文件或目录从工作区物理搬移(Move)至归档区,原位置将不再存在。

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

【目录归档模式】

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

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

【写入后强制校验】

任何归档文件写入后,必须立即回读校验。未完成校验前,不得声称「已成功归档」。调度 archive 工具会在写入后自动回读并输出状态卡片。

输出

请在最终输出的结尾,把archive工具的输出卡片也输出出来。必须以markdown的json代码块输出。

【工具执行指引】

所有归档物生成都必须通过 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 卡片中的 subpatharchive_root 拼接出的完整路径 访问归档区文件。
  4. 异常处理:工具返回错误提示(如 Archive blocked)时须立刻停止归档流程,引用错误原因告知用户并等待下一步指示;禁止在失败后自行补写文件或回执。
Repository
UnicomAI/wanwu
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.