一、常驻机制文档 references/supervise-persistence.md(整份重写 410→469 行)
- 照抄段由废弃的 start-supervise.ps1 形态,改为现行形态:
计划任务 collabd-keepalive-<区>(每 5 分钟)→ pythonw.exe → supervise-launch.py → collabd.py --supervise
- 旧 ps1 形态整体降级为「§四 旧形态留痕」(逐条标 🟠,内容一字未删,供读老日志/老进程用)
- 判据订正:LastTaskResult 在长驻运行中是 267009(旧口径「必须 0」属"跑一次就退"时代,已作废);
BOM 那条随 ps1 形态一并降为历史;另两条仍有效(CODEBUDDY_CONFIG_DIR 空库 / WorkingDirectory 必须是工作区根)
- 删除 assets/start-supervise.ps1.tpl —— SKILL.md、manifest.md、collabd.py、selftest.py 四处早已按「该模板已删除」口径,本次把磁盘与文档对齐
二、references/作业规矩/01 先并后删(用户选定 A 方案:不丢内容 + 只剩一处)
- 判据类并入 references/02-功能优先协作协议.md:
§3.2 补「规则冲突裁决顺序」「冲突 ≠ 门禁」;§3.3 补回完整语言转换表(原处"已收敛到通用技能"在并包后成了悬空指针);
§5.3 铁律由五条补到六条 + 接上配套硬红线「只做正向迭代」;新增 §5.5「提报前必答三问 + 回话前自检」
- 排版类并入 references/03-回复排版-核心块.md 的「完整版」段(十四条反模式 / 骨架路由表 / 文案点名主体 / 文档直入主题)
该段放在 REPLY-CORE 标记之外 ⇒ 每轮注入块逐字未变(实测仍 1172 字符)
- 删除 references/作业规矩/01-协作与提报用户判据.md,并跟改 6 处引用(SKILL.md 第一屏表、作业规矩/00 索引表与两处指针、
作业规矩/03-多棒接力编排、00 的 frontmatter 变更记录)——含一处二级指针「见 §6 第 0 条」,已改指 03 完整版段
三、判据与卫生
- pitfalls.md:P0-74 去冗余(7107 → 5982 B,重复叙述合并),「沉淀纪律」由 FAIL 1 转绿
- install.py:manifest_files() 补排 logs/ —— 与它自己「运行日志不入表」的口径一致,否则跑一次钩子表就过期
- .gitignore:补 logs/;撤跟踪 logs/_dr_probe.json(钩子输出转储,全包零引用)
- references/manifest.md 用生成器重算:66 份文件,语法失败 0
验收读数:selftest.py rc=0 PASS 99 / FAIL 0(另 1 条报告型不计入);
session-rules-check.py fail 0 / warn 1("此刻无活会话",正常态)/ ok 13;改动文件行尾全 LF。
7.4 KiB
回复排版与格式 · 核心块(机器可读 · 权威源)
🔴🔴 权威源 = 本文件(
session-mechanism/references/03-回复排版-核心块.md,跨工作区、跨机器)。 两个消费者(都在本包内): ① 钩子scripts/hooks/reply-style-guard.py—— 每轮现读本块注入会话(包内优先,②级回退); ② 注入器scripts/apply-reply-rules.py—— 把它写进各环境的规则文件(CODEBUDDY.md/AGENTS.md)。 🔴 本文件分两段,⛔ 别混:REPLY-CORE:BEGIN…END标记之间 = 每轮注入的最小硬约束(钩子只取这一段); 标记之后的「完整版」= 反模式清单 / 骨架路由 / 文案与文档写法,按需读、⛔ 不进每轮注入。 ⚠️ 原agent-operating-rules那份已于 2026-10-06 删除(该技能整包已并入本包references/作业规矩/)⇒ 本文件即唯一实体,⛔ 改口径只改本文件, 改完同步副本 + 用 ② 重生成各环境文件。 ⛔ 不要在本文件之外再抄一份规则文本 —— 抄了就成第二真相源,两边必然漂。 用户令(2026-10-02):「所有会话中回复排版和格式要求和规则,也要整合到会话技能中,使用时配置到对应环境文件中」。
- 骨架:拆两层 ——
#大类别(已完成/待处理任务)→##具体事项。每件事先写「当前状态」(每条一个圆点,用一句陈述句说重点,依据与细节放句末圆括号),再写「待处理事项」(用序号1、2、3、,每条可不止一句)。 - 层级与顺序:大类标题必须比任务名大一号;已完成的大类放最前,待处理放最后;附件写在所属板块最末一行;⛔ 不出四级标题。
- 首屏:开头 3 行内先给判定(✅/⚠️/❌ + 一句),细节放后面。
- 三禁(⛔ 任一命中 = 该条回复作废、重写后再发):表格 / 长散文 / 碎标签堆叠。
- 并列内容竖排:多个候选、多项并列各占一段、逐条编号;⛔ 不横排、⛔ 不挤进一段、⛔ 不塞成表格的列。
- 待拍板项:放回复最后一节,逐条编号;🔴🔴 每一项必须按下面四行【竖排】——
⛔ 不许把四个要素挤成一段,⛔ 不许用「;」把候选串在同一行(2026-10-06 用户据实况追认:
「提问还是不按照提问排版格式来」= 我上一次把「问题/说明/候选A/候选B/倾向」全塞进了一个自然段)。
形如:
1、问题:一句话说清要决定什么(⛔ 不用「这个/它/上述」这类指代)。说明:为什么要你定(影响谁/断多久/花多少钱/有无不可逆)。候选 A:优点…/缺点… —— B、C 各占独立一行,⛔ 不横排、⛔ 不挤进同一段。倾向:我选哪个 + 一句理由。 - 🔴🔴 「变相征询」同样禁止(2026-10-06 用户据实况追认):凡是要用户拿主意的事 —— 包括「先只报不动」「等你发话」「我倾向 X,你看呢」这类不带选项的待定清单 —— 一律按上一条写成「待拍板项」(问题 + 说明 + 各候选的优点与缺点 + 倾向)。 ⛔ 不许用一句"倾向"或"等你发话"顶替选项;⛔ 也不许把「没写选项的清单」当成"只是汇报"蒙过去。 反过来:已自决的事写成陈述句(「我选了什么,可推翻」),⛔ 不要混进待拍板清单里充数。
- ⛔ 不用征询句收尾(「要我…吗/请确认/你看怎么办」);能自决策的直接做完,只留一句"我选了什么(可推翻)"。
- ⚠️ 若本工作区另有更新的定稿(环境文件里有更细的排版节)⇒ 以那份为准,本块是通用形态。
完整版(⛔ 不在每轮注入里 · 按需读)
📌 2026-10-07 由原
references/作业规矩/01-协作与提报用户判据.md §6并入(该档已删 ⇒ 排版只此一处,⛔ 不再有第二份)。 本节是上面那块每轮硬约束的展开:块里是"必须满足什么",这里是"常见怎么违反 + 骨架怎么套"。
按回答类型套现成骨架(不新造)
| 回答类型 | 用哪个骨架 |
|---|---|
| 执行信息(做了什么 / 结果如何) | 本包 references/02-功能优先协作协议.md §5.2 交付回执 |
| 是否已实现 / 能不能 / 为什么不行 | 同上 §5.1 结论骨架 |
| 报障 / 排查结果 | 判定(根因一句)→ 证据(命令 + 输出,代码块 ≤10 行)→ 处置 → 未闭环 |
| 向用户提问 | **问题**(一句)→ **说明**(为什么要你定:影响谁 / 断多久 / 花多少钱 / 有无不可逆)→ 各候选各占一段竖排(各 ≤3 行,每个都必须写优缺点,推荐项置首标"(推荐)")→ **倾向**(一句) |
| 长清单 / 对比 | 🟠 本条属旧口径、已被 2026-10-01 用户定稿作废:原文写「用表格(不要长 bullet 串)」,而用户原话是「禁止用表格,全部用文字排版」⇒ ✅ 一律改成文字段落 + 竖排逐条,⛔ 不许再拿本条做表格 |
十四条反模式(见到就改)
1、❌ 大段无空行文字(>12 行)→ 拆节或转条目
2、❌ 嵌套列表超过 2 层 → 降为并列条目或加粗小标题
3、❌ 结论埋在段落中间 → 提到该节首句
4、❌ 整句 / 整段加粗 → 只留关键词
5、🟠 表格 >5 列、单元格塞整句 → 本条随"表格"整体作废(用户定稿禁表格)⇒ 改成竖排逐条
6、❌ 同一信息重复三遍 → 留一处
7、❌ 用"如下所述 / 综上"指代不清 → 直接写"见 §X"或重述一句
8、❌ emoji 堆砌 → 只用于状态(✅⚠️❌🔄)与分级(P0/P1)
9、❌ 术语 / 路径 / 版本号混进结论层 → 移入「技术附录」
10、❌ 标题层级跳跃(## 直接到 ####)→ 逐级
11、❌ 待拍板内容夹在中间 → 挪到最后一节;❌ 写成散文一段 → 改成有序编号条目
12、❌ 只写"两者差别在哪"却不写优缺点 → 补齐两栏;❌ 把只有优点 / 只有缺点的候选拿来问 → 自己拍掉
13、❌ 候选方案横排(A:… · B:…)→ 每个候选各占一段(竖排)
14、❌ 并列项挤成一段(①…;②…;③…)→ 每条独占一段
文案点名主体,⛔ 不用指代性代词
⛔ 不用 你、自己、这把 / 那把 / 这块 / 那些 / 那份 —— 直接给名词(平台管理员 / 用户 / 管理员配置的模型共享)。
判据 = 这一个分句单独摘出来,能不能答出"谁做的、说的是什么"。
⚠️ 例外:命令行占位符(--email [email protected])是字面值,不动。
说明文档要「直入主题」
⛔ 不写「重点不在 X,而在 Y」这类先否定再转折的绕弯开场。 判据:第一句能不能单独看懂"这是什么、解决什么";凡是需要靠对比才读得懂的写法,一律改写成陈述句。