bkn-archive

Name: bkn-archive
Author: kweaver-ai

309stars53forks

How to install bkn-archive?

kweaver-ai/kweaver-dip/bkn-archive

$npx -y skills add kweaver-ai/kweaver-dip --skill bkn-archive

Installs into the current project.

Summary

全局归档协议 — 内化自 archive-protocol。提供 ARCHIVE_ID/TIMESTAMP 生成、双轨归档路径、回读校验与状态回执。

Files · 1

View on GitHub

SKILL.md

1	# 归档协议（内化）
2
3	> 来源：内化自 `archive-protocol` skill。
4	> 当 archive-protocol 更新时，将 `archive-protocol/SKILL.md` 的内容同步至本文件。
5
6	只要当前任务需要写入任何文件，就必须执行本协议。
7
8	归档物包括但不限于：`PLAN.md`、`report.md`、`summary.md`、`result.json`、`notes.md`。
9
10	优先级：本协议高于任何业务协议。定时计划类任务在 `schedule-plan` 技能中约定，且只能调用本归档规则，不能覆盖。
11
12	## 【身份文件】
13
14	若任务需要人格/身份设定，只认：
15
16	- `SOUL.md`
17	- `IDENTITY.md`
18
19	未确认可读或已注入上下文前，不得声称「已成功读取」。
20
21	## 【ARCHIVE_ID 规则】
22
23	### 主路径（OpenClaw）
24
25	`ARCHIVE_ID` 的唯一来源是 `session_status` 工具返回结果中的 `Session`。
26
27	必须执行：
28
29	1. 调用 `session_status`, 并且不允许传递任何参数
30	2. 读取 `Session`
31	3. 使用 `:` 作为分隔符切分 `Session`
32	4. 取切分结果的最后一段作为 `ARCHIVE_ID`
33
34	禁止：
35
36	- 禁止从其他来源生成或推断 `ARCHIVE_ID`
37	- 禁止在 `Session` 为空、缺失或无法切分时伪造 `ARCHIVE_ID`
38	- 若 `session_status` 工具调用失败，立即重试，不允许捏造 `ARCHIVE_ID`
39
40	### 降级路径（非 OpenClaw 平台：Cursor / Claude 等）
41
42	当 `session_status` 工具不可用（平台不支持该 MCP 工具）时，执行以下降级：
43
44	1. 尝试执行 `git rev-parse --short HEAD 2>/dev/null \|\| echo "local"` 获取当前工作区的 Git commit hash（或 `local`）
45	2. 尝试执行 `date "+%m%d-%H%M"` 获取当前日期时间片段
46	3. 拼接为：`ARCHIVE_ID = "<git-hash>-<datetime>"`（如 `a3f2b1c-0416-1430`）
47
48	> 降级 ID 仅用于本地路径区分，不用于 OpenClaw 平台的 Session 关联。
49
50	若降级路径也失败，立即中止归档并返回：`ARCHIVE_STATUS: BLOCKED` / `ARCHIVE_REASON: invalid Session`
51
52	## 【TIMESTAMP 规则】
53
54	生成归档文件前，必须执行：`date "+%Y-%m-%d-%H-%M-%S"`
55
56	时间格式必须固定为：`YYYY-MM-DD-HH-MM-SS`（禁止带空格或冒号）。
57
58	## 【归档路径规则】
59
60	路径执行双轨制，严禁混淆：
61
62	1. 计划文件（PLAN.md 专属）：`archives/{ARCHIVE_ID}/PLAN.md`
63	2. 普通归档物（其他所有生成物）：`archives/{ARCHIVE_ID}/{TIMESTAMP}/{ORIGIN_NAME}`
64
65	根段必须为 `archives`（禁止多一层 `arch`）
66
67	- 所有上述路径在会话工作区内均为相对根，且必须以字面量 `archives/` 作为归档树的第一段（小写完整单词 `archives`，不是 `arch`）。
68	- 禁止在 `archives` 前再拼 `arch/`、`archive/` 或其它目录，形成错误形态如：`arch/archives/...`、`.../arch/archives/{ARCHIVE_ID}/...`。
69	- 禁止用 `arch` 当作 `archives` 的缩写；写路径时心中核对：第一段只能是 `archives`，紧接 `{ARCHIVE_ID}`。
70
71	## 【写入后强制校验】
72
73	任何归档文件写入后，必须立即回读校验。未完成校验前，不得声称「已成功归档」。
74
75	校验内容：文件存在、路径正确、内容非空、关键字段存在、内容与当前任务一致；路径正确须包含：相对归档树以 `archives/` 起头，不得含 `arch/archives/` 等错误多段。
76
77	## 【状态回执与 WebUI 卡片渲染】
78
79	归档结束后，必须按以下格式返回状态。
80
81	OpenClaw 平台：在输出文本回执后，必须输出 `archive_grid` JSON 围栏代码块（供 WebUI 卡片渲染）。
82
83	非 OpenClaw 平台（Cursor / Claude 等）：输出文本回执即可，跳过 JSON 围栏块。
84
85	---
86
87	### JSON 输出形式（OpenClaw 强制）
88
89	- 承载 `archive_grid` 的 JSON 必须以 Markdown 围栏代码块输出：起始行为三个反引号紧跟语言标识 `json`，结束行为单独一行的三个反引号（即标准的 ````json` … ```` ` 结构）。
90	- 禁止：裸 JSON（无围栏）、无语言标签的围栏、语言标签不是 `json`（如 `text`、`plaintext`、留空）。
91	- 每有一个待渲染的归档文件，对应一个上述 ` ```json` 代码块（块内为合法 JSON 对象，含 `type: "archive_grid"` 等字段）。
92
93	- 失败：`ARCHIVE_STATUS: BLOCKED` \| `ARCHIVE_REASON: <原因>`（失败时若无卡片数据，可不输出 JSON 围栏块；若有结构化回执，仍须遵守上文围栏规则。）
94	- 成功：
95	1. 输出文本行：`ARCHIVE_STATUS: OK` \| `ARCHIVE_ROOT: archives/{ARCHIVE_ID}/`
96	2. 按【JSON 输出形式（强制）】输出 `archive_grid`，每一个归档的文件对应一个独立的 ` ```json` 代码块，示例形态如下：
97
98	```json
99	{
100	"type": "archive_grid",
101	"data": {
102	"type": "file",
103	"archive_root": "archives/{ARCHIVE_ID}",
104	"subpath": "{TIMESTAMP}/{ORIGIN_NAME}",
105	"name": "{ORIGIN_NAME}"
106	}
107	}
108	```

People who liked this also viewed

6 picks

Type

find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 20262.6M27k
grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026633k182k
vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026573k29k
improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026522k182k
setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026454k182k
triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026424k182k

bkn-archive

309stars53forks

View on GitHub

How to install bkn-archive?

kweaver-ai/kweaver-dip/bkn-archive

$npx -y skills add kweaver-ai/kweaver-dip --skill bkn-archive

Installs into the current project.

Summary

全局归档协议 — 内化自 archive-protocol。提供 ARCHIVE_ID/TIMESTAMP 生成、双轨归档路径、回读校验与状态回执。

Files · 1

View on GitHub

SKILL.md

1	# 归档协议（内化）
2
3	> 来源：内化自 `archive-protocol` skill。
4	> 当 archive-protocol 更新时，将 `archive-protocol/SKILL.md` 的内容同步至本文件。
5
6	只要当前任务需要写入任何文件，就必须执行本协议。
7
8	归档物包括但不限于：`PLAN.md`、`report.md`、`summary.md`、`result.json`、`notes.md`。
9
10	优先级：本协议高于任何业务协议。定时计划类任务在 `schedule-plan` 技能中约定，且只能调用本归档规则，不能覆盖。
11
12	## 【身份文件】
13
14	若任务需要人格/身份设定，只认：
15
16	- `SOUL.md`
17	- `IDENTITY.md`
18
19	未确认可读或已注入上下文前，不得声称「已成功读取」。
20
21	## 【ARCHIVE_ID 规则】
22
23	### 主路径（OpenClaw）
24
25	`ARCHIVE_ID` 的唯一来源是 `session_status` 工具返回结果中的 `Session`。
26
27	必须执行：
28
29	1. 调用 `session_status`, 并且不允许传递任何参数
30	2. 读取 `Session`
31	3. 使用 `:` 作为分隔符切分 `Session`
32	4. 取切分结果的最后一段作为 `ARCHIVE_ID`
33
34	禁止：
35
36	- 禁止从其他来源生成或推断 `ARCHIVE_ID`
37	- 禁止在 `Session` 为空、缺失或无法切分时伪造 `ARCHIVE_ID`
38	- 若 `session_status` 工具调用失败，立即重试，不允许捏造 `ARCHIVE_ID`
39
40	### 降级路径（非 OpenClaw 平台：Cursor / Claude 等）
41
42	当 `session_status` 工具不可用（平台不支持该 MCP 工具）时，执行以下降级：
43
44	1. 尝试执行 `git rev-parse --short HEAD 2>/dev/null \|\| echo "local"` 获取当前工作区的 Git commit hash（或 `local`）
45	2. 尝试执行 `date "+%m%d-%H%M"` 获取当前日期时间片段
46	3. 拼接为：`ARCHIVE_ID = "<git-hash>-<datetime>"`（如 `a3f2b1c-0416-1430`）
47
48	> 降级 ID 仅用于本地路径区分，不用于 OpenClaw 平台的 Session 关联。
49
50	若降级路径也失败，立即中止归档并返回：`ARCHIVE_STATUS: BLOCKED` / `ARCHIVE_REASON: invalid Session`
51
52	## 【TIMESTAMP 规则】
53
54	生成归档文件前，必须执行：`date "+%Y-%m-%d-%H-%M-%S"`
55
56	时间格式必须固定为：`YYYY-MM-DD-HH-MM-SS`（禁止带空格或冒号）。
57
58	## 【归档路径规则】
59
60	路径执行双轨制，严禁混淆：
61
62	1. 计划文件（PLAN.md 专属）：`archives/{ARCHIVE_ID}/PLAN.md`
63	2. 普通归档物（其他所有生成物）：`archives/{ARCHIVE_ID}/{TIMESTAMP}/{ORIGIN_NAME}`
64
65	根段必须为 `archives`（禁止多一层 `arch`）
66
67	- 所有上述路径在会话工作区内均为相对根，且必须以字面量 `archives/` 作为归档树的第一段（小写完整单词 `archives`，不是 `arch`）。
68	- 禁止在 `archives` 前再拼 `arch/`、`archive/` 或其它目录，形成错误形态如：`arch/archives/...`、`.../arch/archives/{ARCHIVE_ID}/...`。
69	- 禁止用 `arch` 当作 `archives` 的缩写；写路径时心中核对：第一段只能是 `archives`，紧接 `{ARCHIVE_ID}`。
70
71	## 【写入后强制校验】
72
73	任何归档文件写入后，必须立即回读校验。未完成校验前，不得声称「已成功归档」。
74
75	校验内容：文件存在、路径正确、内容非空、关键字段存在、内容与当前任务一致；路径正确须包含：相对归档树以 `archives/` 起头，不得含 `arch/archives/` 等错误多段。
76
77	## 【状态回执与 WebUI 卡片渲染】
78
79	归档结束后，必须按以下格式返回状态。
80
81	OpenClaw 平台：在输出文本回执后，必须输出 `archive_grid` JSON 围栏代码块（供 WebUI 卡片渲染）。
82
83	非 OpenClaw 平台（Cursor / Claude 等）：输出文本回执即可，跳过 JSON 围栏块。
84
85	---
86
87	### JSON 输出形式（OpenClaw 强制）
88
89	- 承载 `archive_grid` 的 JSON 必须以 Markdown 围栏代码块输出：起始行为三个反引号紧跟语言标识 `json`，结束行为单独一行的三个反引号（即标准的 ````json` … ```` ` 结构）。
90	- 禁止：裸 JSON（无围栏）、无语言标签的围栏、语言标签不是 `json`（如 `text`、`plaintext`、留空）。
91	- 每有一个待渲染的归档文件，对应一个上述 ` ```json` 代码块（块内为合法 JSON 对象，含 `type: "archive_grid"` 等字段）。
92
93	- 失败：`ARCHIVE_STATUS: BLOCKED` \| `ARCHIVE_REASON: <原因>`（失败时若无卡片数据，可不输出 JSON 围栏块；若有结构化回执，仍须遵守上文围栏规则。）
94	- 成功：
95	1. 输出文本行：`ARCHIVE_STATUS: OK` \| `ARCHIVE_ROOT: archives/{ARCHIVE_ID}/`
96	2. 按【JSON 输出形式（强制）】输出 `archive_grid`，每一个归档的文件对应一个独立的 ` ```json` 代码块，示例形态如下：
97
98	```json
99	{
100	"type": "archive_grid",
101	"data": {
102	"type": "file",
103	"archive_root": "archives/{ARCHIVE_ID}",
104	"subpath": "{TIMESTAMP}/{ORIGIN_NAME}",
105	"name": "{ORIGIN_NAME}"
106	}
107	}
108	```

People who liked this also viewed

6 picks

Type