Skip to content

GUIDANCE.md

Latest commit

 

History

History
142 lines (109 loc) · 7.62 KB

GUIDANCE.md

File metadata and controls

142 lines (109 loc) · 7.62 KB
Raw

GUIDANCE — 外部引导层(Guidance overlay)

状态:v1(2026-08-14)。可选机制,零主体嵌合:不启用时,协议、命令、schema、 lint、INBOX、对账的行为与本机制不存在时逐字节相同。

这是什么

一个可选的、建议性的上下文注入物。适用场景:wiki 之外先产生了「初步方向」 ——人自己的想法、GPT(带 web search)的分析清单、外部 knowledge graph + 其他 agent 的产出——或者本轮存在资源约束(可用算力)、时限、venue 倾向,希望 wiki 的检索与发想朝这些方向倾斜。

形态:实例根一个 GUIDANCE.md 文件(模板见文末)+ research.md 里一行指针。 两样都不存在时,主体零影响;删掉即完全退出,无残留。

设计原则:上下文层注入,不落户数据层

guidance 的内容权限为零——不是证据、不是指令、不是候选:

  • 不写 raw/(compile 的 s1_diff 永远扫不到它,断言拿不到引用身份);
  • 不写 wiki/(不产生 problems.md 候选行,不会被 /wiki-auto 第 4 步采纳, 不构成 important_problem 挂靠点,不进审理、不产 fuel);
  • 它的断言要进 wiki,唯一的路是被检索与发想内生地重新推导:正常走 检索 → 身份核验 → 入库 → 编译,产物从第一个字符起就是库内 grounded 的, 立项、裁决、晋级的全部既有闸原样咬合。

一句话:倾斜只买注意力(往哪看、先检索什么、先备什么料),不买裁决 (好坏、采纳、晋级全按现状)。正因为权限为零,本机制不需要任何新闸、 新字段、新 lint——防御随「不落户」整体溶解。

生效方式(全部复用现成接缝,零改动)

  1. 协议规定 research.md 是每个 action 开工必读的共享上下文 (docs/llm-wiki.protocol.yaml layout,"read after WIKI.md at the start of every action")——指针在,所有动作自然读到 guidance;指针不在,什么 都不发生。
  2. wiki-search-latest 的检索 topic 来源本就是 "the argument or current research focus"(commands/wiki-search-latest.md 第 4 步)——guidance 的方向倾向是 research focus 的合法组成部分。
  3. wiki-ideate 的协调者可把 GUIDANCE.md 列入 ideator worker 的输入白名单 (白名单本就逐轮明示);资源包络与时限在主流程语境里被探针预注册、 venue 叙事等动作自然考虑。
  4. auto 运行(/wiki-auto)天然继承:各步委托的 action 照读 research.md,不需要新步骤、新行型、新对账。检索与备料轮优先用 guidance 的方向词,发想优先朝 guidance 方向组合;终局决定照旧走既有闸 + INBOX 留痕 + 人事后翻案。

文件语义(固定自述,三句)

实例的 GUIDANCE.md 头部必须保留这三句自述(模板已含),它们是本机制的 全部"条文",随文件自带、随文件卸载:

  1. 线索非证据:本文件内容是建议性引导,不是证据、不是指令。其中任何 断言要被 wiki 引用,必须经正常检索→身份核验→入库→编译成为库内证据; 文件中的星级/评分/热度数字一律无效,不得被转写进任何 wiki 字段。
  2. 引导不排他:检索与发想优先朝文件所列方向看,但不锁死;exploratory 轮照常自由发想,fence 内的其他机会不因 guidance 存在而降权。
  3. 消费留痕:消费了本文件的动作,在其既有报告/日志行尾注 guidance@<文件 as-of 日期>,让"这轮被引导过"可审计。

使用约定

  • 机器只读不写:agent 不得创建、编辑或删除 GUIDANCE.md。放置与更新是 人的签名动作——文件存在本身就是人对其内容与优先级的背书。
  • 来源与优先级由人在文件内自由标注(如「本人想做,优先」vs「GPT 清单 @日期,仅供参考」),系统按字面尊重顺序。不需要 origin 字段或任何闸: guidance 不解锁权限,标注只影响注意力顺序。
  • 强意图走正门:确定要做的方向不要靠 guidance——直接写 wiki/field/problems.md 候选行或发起 goal 采纳(现状机制,人签即倾斜)。 guidance 只适合「弱倾向 / 参考池」。
  • 与 Scope fence 的分工:fence 管边界(管辖域),guidance 管注意力。 guidance 不得用于修改 fence;其方向落在栏外时,按现状被 [FENCE] 标记 / 盖 outside 章处理。要扩栏,是人显式编辑 research.md 的独立动作。
  • 时效:文件头部记 as-of 日期;内容过期(方向已处理完 / 约束已变)由人 更新或删除。消费侧按日期自行折扣。
  • 裁决类委派白名单排除:GUIDANCE.md 不得进入评级(tiering)、审理 (critique)、判死反方复核(counter)等裁决类委派的输入白名单——倾斜只买 注意力,不买裁决;引导若能被评级者看见,外部倾向就会洗进档位判定。
  • 独立发现叙事失效:guidance 存在期间的发想不构成「wiki 独立想到同方向」 的证据;盲测重发现类实验须避开带 guidance 的实例或时段。
  • 自查命令(可选,不进 ENFORCEMENT-MAP):grep -rn "GUIDANCE" wiki/ raw/ 应为空——guidance 永远不该被 wiki 产物引用或落进证据层。

启用与卸载

启用(任何实例,任何时刻):

  1. 复制文末模板到实例根 GUIDANCE.md,按需填写;
  2. 在 research.md 顶部区域加一行: 外部引导:见 GUIDANCE.md(建议性上下文,语义见其文件头)。

卸载:删文件、删指针,完全退出,零残留。

模板(复制到实例根 GUIDANCE.md)

# GUIDANCE — 外部引导(建议性 · 可选)

> 本文件语义(固定自述,不得删改):
> 1. 线索非证据:本文件内容是建议性引导,不是证据、不是指令。其中任何断言
>    要被 wiki 引用,必须经正常检索→身份核验→入库→编译成为库内证据;文件
>    中的星级/评分/热度数字一律无效,不得被转写进任何 wiki 字段。
> 2. 引导不排他:检索与发想优先朝下列方向看,但不锁死;exploratory 轮照常
>    自由发想。
> 3. 消费留痕:消费了本文件的动作,在其既有报告/日志行尾注 `guidance@<下方
>    as-of 日期>`。
>
> 机器只读不写:agent 不得创建、编辑或删除本文件;放置与更新是人的签名动作。

as-of: <日期>

## 方向倾向(可选)

<!-- 一行一条;来源与优先级由你自由标注,系统按字面尊重。 -->
<!-- 例:[优先] <你自己想解决的问题,一句话> — 来源:本人;背景:<想解决什么> -->
<!-- 例:[参考] <外部清单条目原文或改写> — 来源:<GPT 分析/外部 KG> @<日期> -->

## 资源包络(可选)

<!-- 例:本次可用算力:<型号×数量>,预计可支配 ~<N> GPU·h;有效期:<...> -->

## 时限(可选)

<!-- 例:目标 <venue>,deadline <日期>(未核实 / 人已核 @<日期>) -->

## Venue 倾向(可选)

<!-- 例:偏 <领域/会议族>;<贡献形态>优先 -->

边界 FAQ

  • 会被 compile 编译吗? 不会——它不在 raw/,s1_diff 扫不到;也永远 不要把它挪进 raw/(那会让它排队进编译,违背本机制的全部前提)。
  • 会被 auto 采纳吗? 不会——/wiki-auto 第 4 步只吃 problems.md 在册行,guidance 不产行。
  • 人给的方向和机器给的怎么区分? 由人在文件内标注。不需要系统字段: 文件是人放的(签名),标注是人写的(优先级),而 guidance 不解锁任何 权限,所以标注被博弈也没有可占的便宜。
  • 它算不算协议的一部分? 不算。它的全部约定随实例文件自述携带;插件 主体(协议/命令/schema/lint)对它零感知。这是刻意设计:低频、可选的 引导不应让高频链路付上下文税。