// 全局归档协议 — 内化自 archive-protocol。提供 ARCHIVE_ID/TIMESTAMP 生成、双轨归档路径、回读校验与状态回执。
| name | bkn-archive |
| description | 全局归档协议 — 内化自 archive-protocol。提供 ARCHIVE_ID/TIMESTAMP 生成、双轨归档路径、回读校验与状态回执。 |
来源：内化自
archive-protocolskill。 当 archive-protocol 更新时，将archive-protocol/SKILL.md的内容同步至本文件。
只要当前任务需要写入任何文件，就必须执行本协议。
归档物包括但不限于：PLAN.md、report.md、summary.md、result.json、notes.md。
优先级：本协议高于任何业务协议。定时计划类任务在 schedule-plan 技能中约定，且只能调用本归档规则，不能覆盖。
若任务需要人格/身份设定，只认：
SOUL.mdIDENTITY.md未确认可读或已注入上下文前，不得声称「已成功读取」。
ARCHIVE_ID 的唯一来源是 session_status 工具返回结果中的 Session。
必须执行：
session_status, 并且不允许传递任何参数Session: 作为分隔符切分 SessionARCHIVE_ID禁止：
ARCHIVE_IDSession 为空、缺失或无法切分时伪造 ARCHIVE_IDsession_status 工具调用失败，立即重试，不允许捏造 ARCHIVE_ID当 session_status 工具不可用（平台不支持该 MCP 工具）时，执行以下降级：
git rev-parse --short HEAD 2>/dev/null || echo "local" 获取当前工作区的 Git commit hash（或 local）date "+%m%d-%H%M" 获取当前日期时间片段ARCHIVE_ID = "<git-hash>-<datetime>"（如 a3f2b1c-0416-1430）降级 ID 仅用于本地路径区分，不用于 OpenClaw 平台的 Session 关联。
若降级路径也失败，立即中止归档并返回：ARCHIVE_STATUS: BLOCKED / ARCHIVE_REASON: invalid Session
生成归档文件前，必须执行：date "+%Y-%m-%d-%H-%M-%S"
时间格式必须固定为：YYYY-MM-DD-HH-MM-SS（禁止带空格或冒号）。
路径执行双轨制，严禁混淆：
archives/{ARCHIVE_ID}/PLAN.mdarchives/{ARCHIVE_ID}/{TIMESTAMP}/{ORIGIN_NAME}根段必须为 archives（禁止多一层 arch）
archives/ 作为归档树的第一段（小写完整单词 archives，不是 arch）。archives 前再拼 arch/、archive/ 或其它目录，形成错误形态如：arch/archives/...、.../arch/archives/{ARCHIVE_ID}/...。arch 当作 archives 的缩写；写路径时心中核对：第一段只能是 archives，紧接 {ARCHIVE_ID}。任何归档文件写入后，必须立即回读校验。未完成校验前，不得声称「已成功归档」。
校验内容：文件存在、路径正确、内容非空、关键字段存在、内容与当前任务一致；路径正确须包含：相对归档树以 archives/ 起头，不得含 arch/archives/ 等错误多段。
归档结束后，必须按以下格式返回状态。
OpenClaw 平台：在输出文本回执后，必须输出 archive_grid JSON 围栏代码块（供 WebUI 卡片渲染）。
非 OpenClaw 平台（Cursor / Claude 等）：输出文本回执即可，跳过 JSON 围栏块。
承载 archive_grid 的 JSON 必须以 Markdown 围栏代码块输出：起始行为三个反引号紧跟语言标识 json，结束行为单独一行的三个反引号（即标准的 json` … ` 结构）。
禁止：裸 JSON（无围栏）、无语言标签的围栏、语言标签不是 json（如 text、plaintext、留空）。
每有一个待渲染的归档文件，对应一个上述 ```json 代码块（块内为合法 JSON 对象，含 type: "archive_grid" 等字段）。
失败：ARCHIVE_STATUS: BLOCKED | ARCHIVE_REASON: <原因>（失败时若无卡片数据，可不输出 JSON 围栏块；若有结构化回执，仍须遵守上文围栏规则。）
成功：
ARCHIVE_STATUS: OK | ARCHIVE_ROOT: archives/{ARCHIVE_ID}/archive_grid，每一个归档的文件对应一个独立的 ```json 代码块，示例形态如下：{
"type": "archive_grid",
"data": {
"type": "file",
"archive_root": "archives/{ARCHIVE_ID}",
"subpath": "{TIMESTAMP}/{ORIGIN_NAME}",
"name": "{ORIGIN_NAME}"
}
}
数据权限管理技能：支持资源权限查询与权限申请。 先判定“查询权限”还是“申请权限”，再按资源类型执行对应接口。 当用户提出“申请权限”、“查是否有权限”、“给某资源授权”时使用。
数据分析员工（Data Analyst Agent）的唯一总入口：凡与数据资产、取数、指标、表/视图、 治理职责、知识网络等相关的问题，必须先经本 skill 做编排与路由，再进入找表或问数等子流程。 当用户提出数据类问题、需要知识网络选择、或需要在找表与问数之间切换时使用。
向飞书指定用户（通过 user_id）推送消息。 支持文本、卡片、图片、文件等多种消息类型。当用户需要给飞书用户发送推送消息时自动使用。
全局归档协议。只要任务需要写入任何文件（含 PLAN.md、报告、JSON 等归档物），必须按本技能执行 Session→ARCHIVE_ID、TIMESTAMP、双轨路径（根段须为 archives/）、回读校验与状态回执；WebUI 的 archive_grid 必须用 Markdown 中语言标识为 json 的围栏代码块输出。
KWeaver CLI 操作层 — 内化自 kweaver-core。 覆盖认证、平台业务域（config）、知识网络管理与查询、Agent CRUD 与对话、 数据源管理、数据视图、Skill 注册、Vega 可观测、context-loader 语义搜索、通用 API 调用。 仅由 bkn-creator pipeline 内部读取，不独立注册到宿主 skill 系统。
BKN 全生命周期编排入口。自包含 KWeaver CLI 操作层（内化 bkn-kweaver）。 凡涉及创建 BKN、从 PRD/文档提取对象关系、 生成或更新 `.bkn`、做数据视图绑定、环境检查、测试集生成、校验与推送时， 优先使用 bkn-creator 进行流程路由、阶段门禁、子 skill 编排与结果回执。 适用于 BKN 的 create/read/update/delete/extract/copy/validate 场景， 技能包能力补齐/skill 草案生成场景， 以及使用反馈巡检与改进场景（定时任务触发、Agent 对话质量异常、 feedback_brief 传入、知识网络持续优化）。 不应用于纯数据语义查询，该场景应交由 data-semantic 处理。