wiki-room

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill: wiki-room

Tier C của wiki-core v2 (concept

wiki-core-relations

): khi context phiên chính đã dài/rot, KHÔNG nạp thêm chi tiết vào phiên chính — mở MỘT room (subagent) nạp đầy đủ rồi trả về kết luận nén. Phiên chính giữ bản đồ (Tier A), chi tiết sống trong room dùng-xong-bỏ.

wiki-core v2 的 Tier C（concept

wiki-core-relations

）：当主会话的 context 过长或已经 rot 时，不要将更多细节加载到主会话中——开启一个 room（subagent），完整加载后返回压缩后的结论。主会话保留地图（Tier A），细节则放在一次性 room 中，用完即弃。

WHAT

Purpose và context

Purpose 和 context

Purpose: trả lời câu hỏi cần chi tiết sâu từ nhiều trang wiki mà KHÔNG làm phình context phiên chính — chi tiết đọc trong một room (subagent) dùng-xong-bỏ, phiên chính chỉ nhận kết luận nén có nguồn.
Trigger (when to use):
- Phiên chính đã dài (nhiều lần tóm tắt/summarize) mà cần chi tiết sâu từ nhiều trang wiki.
- Câu hỏi cần đọc >3 trang wiki đầy đủ + hàng xóm quan hệ của chúng.
- User nói "mở room", "context rot", "nạp thêm chi tiết wiki", "đào sâu wiki",
```
/wiki-room
```
  .
Non-goals:
- KHÔNG dùng khi chỉ cần 1-2 trang cụ thể — đọc thẳng rẻ hơn một room (tiêu chí tốc độ).
- Không phải trí nhớ dài hạn — tri thức đọng lại phải distill vào wiki qua
```
/ingest
```
  hoặc cập nhật trang.
- Không sửa wiki; room chỉ đọc và tổng hợp.

Purpose： 回答需要从多个 wiki 页面获取深层细节的问题，同时不膨胀主会话的 context——细节在一个一次性 room（subagent）中读取，用完即弃；主会话只接收带来源的压缩结论。
Trigger（何时使用）：
- 主会话已经很长（多次 summarize），且需要从多个 wiki 页面获取深层细节。
- 问题需要完整阅读超过 3 个 wiki 页面，并浏览它们的关系邻居。
- 用户说出“mở room”、“context rot”、“nạp thêm chi tiết wiki”、“đào sâu wiki”或
```
/wiki-room
```
  。
Non-goals：
- 当只需要 1–2 个特定页面时不要使用——直接读取比开启一个 room 更快（以速度为优先）。
- 它不是长期记忆——沉淀下来的知识必须通过
```
/ingest
```
  distill 到 wiki，或更新页面。
- 不修改 wiki；room 只负责读取和综合。

Mental model

câu hỏi → brief Tier A (list id + trang stale + episode mồi) → budget B → MỘT room (subagent, depth 1) đọc Tier B + hàng xóm 1 bước → kết luận nén ≤500 từ có nguồn → phiên chính hành động

问题 → Tier A brief（页面 id 列表 + stale 页面 + 种子 episode）→ budget B → 一个 room（subagent，depth 1）读取 Tier B + 1 跳关系邻居 → 带来源的 ≤500 词压缩结论 → 主会话执行操作

。

Input và output contract

Input 和 output contract

	Field	Required?	Ý nghĩa
In	câu hỏi	có	điều cần đào sâu trong wiki
In	budget B	không (mặc định 12)	trần số trang Tier B, gồm cả hàng xóm quan hệ 1 bước
In	list id trang	tự lập ở W01	từ câu hỏi + `wiki/index.md` + `wiki/stale.json` + truy hồi episode
Out	kết luận nén	có	≤500 từ, mọi khẳng định kèm trang nguồn; trang stale gắn cờ; chạm budget → ghi "đã chạm budget, chưa đọc: <list>"; thiếu dữ liệu → "thiếu: <gì>"

"Xong" = phiên chính nhận kết luận nén và hành động tiếp trên đó, không paste toàn văn trang.

	字段	是否必需？	含义
In	问题	是	需要在 wiki 中深入查找的内容
In	budget B	否（默认 12）	Tier B 页面的数量上限，包括 1 跳关系邻居
In	页面 id 列表	在 W01 中自动生成	根据问题、 `wiki/index.md` 、 `wiki/stale.json` 和 episode 检索结果生成
Out	压缩结论	是	≤500 词；每项断言均附来源页面；stale 页面须加标记；触及 budget 时写入“已触及 budget，未读取：<list>”；缺少数据时写入“缺少：<内容>”

“完成”= 主会话收到压缩结论并据此继续操作，而不是粘贴页面的完整正文。

Rules và capabilities

Rules 和 capabilities

Ba luật cứng (chép NGUYÊN VĂN vào prompt room):

RULE-01 (MUST): Depth cap = 1 (G3): room KHÔNG được mở room/subagent con dưới bất kỳ lý do gì. Thiếu dữ liệu → ghi "thiếu: <gì>" vào kết luận, để phiên chính quyết.
RULE-02 (MUST): Budget cứng: đọc tối đa B trang. Chạm trần → DỪNG đọc, tổng hợp từ những gì đã có (circuit breaker — trả kết quả cắt ngắn kèm ghi chú "đã chạm budget, chưa đọc: <list>").
RULE-03 (MUST): Kết luận nén có nguồn: mọi khẳng định kèm trang nguồn (
```
concepts/x.md
```
); trang nguồn đang stale (theo brief) phải ghi kèm cờ "(stale — kiểm chứng lại trước khi tin)".

Anti-patterns (luật phụ cho phiên chính):

RULE-04 (MUST NOT): Mở nhiều room song song cho một câu hỏi (mất kiểm soát budget tổng) — một câu hỏi, một room.
RULE-05 (MUST NOT): Dùng room như trí nhớ dài hạn — room là dùng-xong-bỏ; tri thức đọng lại phải distill vào wiki qua
```
/ingest
```
hoặc cập nhật trang, không nằm trong transcript room.
RULE-06 (SHOULD NOT): Gọi room khi phiên chính còn ngắn — đọc thẳng luôn nhanh hơn.
Capabilities: đọc wiki (index, stale list, frontmatter
```
relations:
```
); truy hồi ngữ nghĩa episodic; spawn đúng một subagent read-only. Không ghi wiki.

三条硬性规则（逐字复制到 room prompt 中）：

RULE-01 (MUST)：Depth cap = 1 (G3)： room 不得因任何理由开启子 room/subagent。缺少数据时，在结论中写入“缺少：<内容>”，交由主会话决定。
RULE-02 (MUST)：硬性 budget： 最多读取 B 个页面。触及上限时立即停止读取，仅根据已有内容进行综合（circuit breaker——返回截短的结论，并附注“已触及 budget，未读取：<list>”）。
RULE-03 (MUST)：带来源的压缩结论： 每项断言均须附来源页面（
```
concepts/x.md
```
）；根据 brief 标记为 stale 的来源页面，必须附上“(stale — 信任前请重新验证)”标记。

Anti-patterns（主会话的辅助规则）：

RULE-04 (MUST NOT)：针对一个问题并行开启多个 room（会失去对总 budget 的控制）——一个问题对应一个 room。
RULE-05 (MUST NOT)：将 room 用作长期记忆——room 应一次使用后即弃；沉淀的知识必须通过
```
/ingest
```
distill 到 wiki，或直接更新页面，不能只留在 room transcript 中。
RULE-06 (SHOULD NOT)：当主会话仍然较短时调用 room——直接读取始终更快。
Capabilities：读取 wiki（index、stale 列表、frontmatter 中的
```
relations:
```
）；执行 episodic 语义检索；spawn 恰好一个只读 subagent。不得写入 wiki。

Failure boundaries

Câu hỏi chỉ cần 1-2 trang → không mở room, đọc thẳng (từ chối hợp lệ).
Room chạm budget B → partial: kết luận cắt ngắn + list trang chưa đọc.
Room thiếu dữ liệu → ghi "thiếu: <gì>", phiên chính quyết (không mở room con).
Trang nguồn stale → vẫn dùng nhưng gắn cờ kiểm chứng lại.

问题只需要 1–2 个页面 → 不开启 room，直接读取（合理拒绝）。
Room 触及 budget B → partial： 返回截短的结论，并附带尚未读取的页面列表。
Room 缺少数据 → 写入“缺少：<内容>”，由主会话决定（不开启子 room）。
来源页面为 stale → 仍可使用，但必须标记为需要重新验证。

HOW

Main workflow

Step	Type	Inputs	Action	Outputs/exit	Failure/next
W01	judgment	câu hỏi, `wiki/index.md` , `wiki/stale.json` , `mem-rank.py`	Lập brief Tier A (phiên chính, rẻ)	list id trang + cờ stale + episode mồi	≤2 trang → đọc thẳng, dừng
W02	deterministic	list id, frontmatter `relations:`	Chốt budget B TRƯỚC khi mở (mặc định 12, gồm hàng xóm 1 bước)	B + list trong trần	—
W03	effect	brief, B, 3 luật cứng	Mở ĐÚNG MỘT room (subagent Explore/general-purpose)	room chạy	—
W04	judgment	kết luận room	Nhận kết luận nén (≤500 từ + nguồn), hành động tiếp	quyết định phiên chính	chạm budget/thiếu → B01

Chi tiết từng bước (nguồn chân lý cho W01–W04):

Lập brief Tier A (phiên chính, rẻ): thu list id trang cần đào — từ câu hỏi +
```
wiki/index.md
```
- ```
wiki/stale.json
```
  (trang stale liên quan phải nêu rõ trong brief là "có thể lỗi thời"). Mồi thêm bằng truy hồi NGỮ NGHĨA episodic:
```
python3 harness/scripts/mem-rank.py retrieve "<câu hỏi>" --kind-filter episode
```
  — bắt "phiên trước làm gì" mà không cần
```
[[wikilink]]
```
  ; đưa các file/episode nổi lên vào brief cho room.
Chốt budget TRƯỚC khi mở: tối đa B trang Tier B (mặc định 12) + hàng xóm quan hệ 1 bước (đọc
```
relations:
```
frontmatter của các trang trong list — cũng tính vào B).
Mở ĐÚNG MỘT room: spawn 1 subagent Explore/general-purpose với prompt gồm: câu hỏi, list id, budget B, và 3 luật cứng ở mục Rules (chép nguyên văn vào prompt).
Nhận kết luận nén (≤500 từ + trích dẫn nguồn), phiên chính hành động tiếp trên đó — KHÔNG paste toàn văn các trang room đã đọc vào phiên chính.

步骤	类型	输入	操作	输出/退出	失败/下一步
W01	judgment	问题、 `wiki/index.md` 、 `wiki/stale.json` 、 `mem-rank.py`	构建 Tier A brief（主会话，低成本）	页面 id 列表 + stale 标记 + 种子 episode	≤2 个页面 → 直接读取并停止
W02	deterministic	页面 id 列表、frontmatter 中的 `relations:`	开启前锁定 budget B（默认 12，包括 1 跳关系邻居）	B + 包含在上限内的列表	—
W03	effect	brief、B、三条硬性规则	开启恰好一个 room（subagent Explore/general-purpose）	room 运行	—
W04	judgment	room 结论	接收压缩结论（≤500 词 + 来源），并继续操作	主会话作出决定	触及 budget/缺少数据 → B01

各步骤的权威依据（W01–W04）：

构建 Tier A brief（主会话，低成本）： 根据问题、
```
wiki/index.md
```
和
```
wiki/stale.json
```
收集需要深入查找的页面 id 列表；相关 stale 页面必须在 brief 中明确标为“可能已过时”。再通过 episodic 语义检索添加种子：
```
python3 harness/scripts/mem-rank.py retrieve "<问题>" --kind-filter episode
```
——无需
```
[[wikilink]]
```
即可捕获“之前会话做了什么”；将突出的文件/episode 加入 brief 并传给 room。
开启前锁定 budget： 最多读取 B 个 Tier B 页面（默认 12），并读取 1 跳关系邻居（读取列表中各页面的
```
relations:
```
frontmatter；这些页面同样计入 B）。
开启恰好一个 room： spawn 一个 subagent Explore/general-purpose，其 prompt 包含：问题、页面 id 列表、 budget B，以及 Rules 部分的三条硬性规则（逐字复制）。
接收压缩结论（≤500 词 + 来源引用），主会话据此继续操作—— 不要将 room 已读取页面的完整正文粘贴到主会话中。

Branches

ID	Kind	Guard	Hành vi	Skip / failure	Rejoin
B01	recovery	room chạm budget B hoặc báo "thiếu: <gì>"	phiên chính quyết: dùng kết luận cắt ngắn, hoặc đọc thẳng vài trang còn thiếu	không mở room con, không mở room thứ hai song song	W04

ID	类型	Guard	行为	跳过/失败	重新汇合
B01	recovery	room 触及 budget B 或报告“缺少：<内容>”	主会话决定：使用截短的结论，或直接读取少数缺失页面	不开启子 room，也不并行开启第二个 room	W04

Validation và stopping

Validation 和 stopping

Room dừng khi đọc đủ list hoặc chạm B (circuit breaker tất định theo đếm trang). Kiểm bằng review: kết luận ≤500 từ, mọi khẳng định có trang nguồn, trang stale có cờ. Một câu hỏi = tối đa một room.

当 room 读完列表或触及 B 时停止（采用按页面计数实现的确定性 circuit breaker）。通过 review 检查：结论 ≤500 词，每项断言均有来源页面，stale 页面均已加标记。一个问题最多使用一个 room。

Examples

Positive: phiên dài, hỏi "wiki-core v2 xử lý stale ra sao qua các tier?" → brief 6 trang + 3 hàng xóm (B=12) → một room → kết luận 400 từ trích
```
concepts/wiki-core-relations.md
```
, một trang gắn "(stale — kiểm chứng lại trước khi tin)".
Boundary/failure: câu hỏi cần 20 trang, B=12 → room dừng ở trang 12, trả kết luận kèm "đã chạm budget, chưa đọc: <8 trang>"; không mở room con.
Boundary: chỉ cần
```
concepts/solid-what-how.md
```
→ không mở room, đọc thẳng.

Positive： 主会话较长，询问“wiki-core v2 如何通过各个 tier 处理 stale？”→ brief 包含 6 个页面 + 3 个邻居（B=12）→ 开启一个 room → 返回 400 词的结论，引用
```
concepts/wiki-core-relations.md
```
，其中一个页面标记为“(stale — 信任前请重新验证)”。
Boundary/failure： 问题需要 20 个页面，B=12 → room 在第 12 个页面停止，返回结论并附注“已触及 budget，未读取：<8 个页面>”；不开启子 room。
Boundary： 只需要
```
concepts/solid-what-how.md
```
→ 不开启 room，直接读取。

Origin

Source: concept
```
wiki-core-relations
```
§2.4 Tier C + council 020726 guardrail G3/G6
Date: 2026-07-02

Source： concept
```
wiki-core-relations
```
§2.4 Tier C + council 020726 guardrail G3/G6
Date： 2026-07-02