0 Fork 0

Files

T

admin 61962f1726 补入本地今日改动：session-mechanism ＋ product-planning（按用户令改推本仓库）

背景：旧远端 work.alotbuy.com 今天一直连不上（222／22 端口都不通）⇒ 今天本地累积多条提交推不上去；
用户令改推本仓库 [email protected]:admin/workbuddy_skills.git（只推这 5 个技能：
browser-harness / humanizer / humanizer-zh / product-planning / session-mechanism）。

本次改动（对照本机已安装的技能源逐文件 md5 比对得出，⛔ 是「补差异」不是「整体覆盖」）：
· session-mechanism：含今天两条钩子改动（派活收工闸、点名加载收工闸）、
  rules.md §9「只写正向范围」、检查程序静默阈值 10→6、检查排期补 workspace_scope（修未分组）、
  以及今天修的三处陈旧指针（旧技能名 dsh-decision / agent-operating-rules 与旧路径编号）。
· product-planning：第③段「随段样式风格库」并入 design-system-tiaoyue、竞品分析方法论重写等。
· humanizer / humanizer-zh：已一致，零改动。
· browser-harness：比对出的 7 个「本地独有」全是**它自己 .gitignore 里就排除的**构建产物
  （src/*.egg-info/ 与 uv.lock）⇒ 按该技能自己的规矩不推（用户口径「不要环境」）。

仓库级配置（与旧仓一致）：core.autocrlf=false；身份 maogeigei <[email protected]>。
⚠️ 克隆时仓库默认 autocrlf=true（会把行尾转成 CRLF）⇒ 已改回 false 并重新暂存，
   核对索引 blob 均为 LF、真实差异 23 个（⛔ 不是把几百个文件一起改掉）。

2026-10-07 20:33:49 +08:00

4.4 KiB

Raw Blame History

文档索引 · 干什么事该看哪一篇（★ 2026-10-04 建）

🔴 本档只解决一件事：别通读文档。 按下表跳，⛔ 不许「先都读一遍」。 ⚠️ 落它的起因：文档已 14 篇 + SKILL.md，改流程/改机制时不知道必看哪几篇 ⇒ 出现过「昨天写好的红线，今天换个会话又踩一遍」（2026-10-03 立的「⛔ 写会怎样前先取证」，只躺在工作区日志里，换会话读不到 ⇒ 10-04 复发）。

⓿ 🔴 改流程／改机制前的必读三篇（顺序别换）

序	必读	读多久	为什么是它
1	`00-动手前必过.md`	3 分钟	六条动作红线。⛔ 开工前只读这一篇就够，⛔ 别通读 pitfalls
2	`rules.md`	5 分钟	现行规则本体（⛔ 不是过程记录；历史在 `pitfalls.md`）
3	`manifest.md`	2 分钟	清单：哪些文件是什么、哪个是权威。⛔ 改之前先确认你改的那份是权威

一句话：⓿ 三篇加起来 10 分钟，能避开今天栽的每一类。

一、按「你要干什么」跳

你要干的事	必看	⛔ 不用看
改流程／改机制／改正则	`00-动手前必过.md` ＋ `rules.md` ＋ `manifest.md`	`pitfalls.md` 全篇
说错了话、想找根因	`pitfalls.md`（按编号查，⛔ 别通读）	—
常驻挂了／要开机自启	`supervise-persistence.md`（唯一权威）	`architecture.md`
看板显示不对	`collab-detail.md`	`architecture.md`
换机器／装钩子	`deploy.md` ＋ `install.py`	其余全部
会话卡住／日志爆了／抢锁	`SKILL.md` §1 加载块	`pitfalls.md`
查某个历史会话干了啥	`forensics.md`	—
任务图／多会话分工	`taskgraph.md` ＋ `collab.md`	—
怎么回话／排版	`03-回复排版-核心块.md` ＋ `02-功能优先协作协议.md`	—
对方甩来一句没头绪的话	`02-功能优先协作协议.md`	—
只想要速查	`99-速查清单.md`	—
问「这是什么、为什么这样」	`architecture.md`	—
要把一个话题讲清楚（文字 → 图 → 互动页三级递进）	`karpathy-output-ladder/SKILL.md`（随包子技能）	—

📌 karpathy-output-ladder/ 是随包子技能（2026-10-07 按用户令从全局 skills 移入本包 references/，内容逐字未改）。 ⚠️ 它的"用法"尚未接线（用户原话「后续再看如何使用」）⇒ 现在只做到"找得到"：想用它时按上面那行跳过去读它自己的 SKILL.md；⛔ 不参与本包的钩子/判据/自动加载。

二、🔴 文档四条规则（写文档／改文档时必守）

分类索引 —— 新增文档必须在这张表里登记（⛔ 没登记 = 别人找不到 = 白写）。
结论在最前，过程记录在后 —— 读者要的是「现在是什么样」，⛔ 不是「我改了几轮」。
历史记录按时间倒排 —— 新的在前面，旧的在后面（⛔ 追加只能往前插，⛔ 不许接在末尾）。
简明扼要有效 —— 单条 ≤6 KB；⛔ 论证过程／对比表格／逐条展开全删； ⚠️ 但判据要点一个不许丢（长度达标而判据被删 = 更坏，那是假绿）。
🔴 只写正向范围，⛔ 不写「不用于 XXXX」（2026-10-07 用户令） —— 规则正文在 rules.md §9（⛔ 只一处，本行只作指针）。一句话：技能/文档的"用途／范围"段一律写用于什么；列"不用于 A／B／C"会把 A／B／C 喂进自动匹配面 ⇒ 反而更容易被误命中。

三、🔴 为什么「存档」不等于「读得到」（10-04 实证）

档位	装什么	跨会话可见
`references/*.md` ＋ `SKILL.md`	规矩	✅ 技能会自动加载
`.workbuddy/memory/<日期>.md`	过程记录（当天做了什么）	❌ 只有那个工作区翻才看得到
源码注释＋ git 历史	细节与来路	⛔ 没人会去看

⚠️ 10-04 的教训：一条红线立在对的地方（工作区日志 197 KB），仍然等于没立 ⇒ 凡是「下次必须做到」的事，必须落在 references/ 或 SKILL.md，⛔ 不能只写日志。 判据：selftest.py::t_no_invented_consequence 量的就是这个（红线在动手层第一段）。

4.4 KiB Raw Blame History Unescape Escape