admin/workbuddy_skills
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
91 Commits 1 Branch 0 Tags
5c5272569f6da83591480b88a5f5bc902d2b4866
Commit Graph
6 Commits
Author SHA1 Message Date
admin 74b407ccba session-mechanism：加「锁根不得落进技能包」红线判据 
按决策方法论自决（加判据属"实现路径"，⛔ 不列入待拍板）。

新增 `session-rules-check.py::check_lockroot_in_pkg()`，注册进体检 A 组：
查 `<技能包>/05-交接单/` 与 `<技能包>/scripts/05-交接单/` 是否被创建
（三个根都查：脚本所在包根、全局技能根下的 session-mechanism、本区技能根下的同名目录）。

为什么是红线：`lock/handoff-guard.sh` 与 `lock/preflight-lock.sh` 的 `DOCS_ROOT`
原先回落到 `$_SM_HERE/..`（＝技能包自己的 `scripts/`）⇒ 取不到文档库根时锁目录长在包里
（另一环境实测已出现 `<技能包>/scripts/05-交接单/.locks/`）。后果两条：污染只读发布物；
换工作区后锁跟错地方 ⇒ 域锁静默失效。
两处回落实已改为「取不到就报错 ＋ 留痕 ＋ 退出码 2」（9b839e7 / 22799fc）；本条是兜底判据。

变异对照（⛔ 证明它抓得住、不是恒绿）：
· 常态 ⇒ `✓ [A] 锁根未落进技能包`
· `mkdir -p <技能包>/scripts/05-交接单` 后 ⇒ `✗ [A] 锁根落进了技能包 ⇒ …`
· `rmdir` 复原 ⇒ 回到 ✓

⛔ 未做成 selftest 自动化用例：那要求真在技能包里造目录，用例中断会把 `05-交接单`
永久留在包里（不可逆污染）。⇒ 保留为判据 docstring 里可手工复现的步骤。

验收：语法 OK；全量自测 PASS 110 / FAIL 0。
 2026-10-15 22:50:46 +08:00
admin 2f656098de 技能仓：技能根绝对路径清零（用户令：严格禁止技能中写这里绝对路径） 
用户原话：「SKILL.md:189 判据源写 E:/ProgramData/.workbuddy/skills/
严格禁止技能中写这里绝对路径（除非跨根目录因引用），跨环境全部报错」

起因：product-planning/SKILL.md:189「判据来源」那句写了技能根绝对路径。
按同一判据全仓反查后清掉 10 个文件：

· product-planning：SKILL.md（判据来源 / video-capture 位置 / 本技能位置 ＋ 新增「路径写相对或占位」规则）、
  references/_留痕/SKILL-总入口-20261007改说人话前.md、stage-delivery/assets/video-capture/SKILL.md、
  scripts/check_naming.py（注释）
· session-mechanism：SKILL.md（反例改占位 ＋ 例外条款改写：由「文档／注释不在此列」改为「例外只有跨根引用」）、
  references/deploy.md（安装目录）、scripts/session-rules-check.py（docstring）、
  boards/会话看板/board-launch.py.tpl（模板占位符）
· video-capture：ATTRIBUTION.md（沿革）
· 改包纪律.md：3 条 cd 命令

判据（用户给的两分法）：
· 技能根（本包自己 ＋ 同根技能）⇒ 一律不写绝对路径，写 <技能根>/<技能名>/
· 跨根引用（工作区根 / 文档库根 / 本机软件安装位 / 宿主数据目录）⇒ 才落到具体位置，优先读环境变量

验收：
· product-planning 命名闸门：通过 2060 / 失败 0
· session-mechanism 全量自测：PASS 110 / FAIL 0
· 全仓 grep -r 反查该形态：清零（install.log 为运行时产物已 ignore；browser-harness/.venv 为 pip 元数据）
· 3 个被编辑器写成 CRLF 的文件已转回 LF，与 .gitattributes 的 eol=lf 对齐
 2026-10-14 21:10:29 +08:00
admin 053a6a6723 session-mechanism：主会话只能由用户开（撤掉"排期建主会话"那条路） 
用户报障：「技能中没有任何创建主会话的机制，除非是创建接续会话」。

病灶：supervise-persistence.md §〇 早期把「定时任务创建主会话」与「用户手动
创建主会话」并列成两种合法场景，SKILL.md §⑥ 顺着抄了一遍 ⇒ 读到的人会理解成
"这条路是允许的"，于是照做。

实测事故（mcn-aigc-ontology 2026-10-14 07:31）：init_workspace 装机制后建出
recurring 排期 [主]-super-i卡片采集-主会话（FREQ=DAILY;BYHOUR=09），prompt 里
写着「你是本工作区的主会话……要推进就直接建 [执行] 排期拉起任务会话」——
主会话的口径被套到了一条排期身上。排期开出来的会话恒是任务会话那一档
（is_background_automation=1）⇒ 台账里多一条"主会话"，用户那边没多窗口。

改动：
- SKILL.md §⑥：改成「形态只有一种：主会话由用户手动开」，⛔ 排期拉不出主会话
- supervise-persistence.md §〇：表格两列改一列 + 新增事故回放小节
- supervise-persistence.md §八：删掉「B · 定时任务创建主会话」整行
- architecture.md §1：新增《主会话怎么来：只能由用户手动开》段
- session-rules-check.py：新增判据 ⑬ main_sched（扫排期名以 [主] 开头或含
  "主会话" ⇒ ACTIVE 报 fail、非 ACTIVE 报 warn）；扫描面 recurring 与 once 全含
- SKILL.md 体检清单：十二项 → 十三项，补 ⑬ 变异对照记录

判据验收（非恒绿）：喂 mcn 区真数据三种输入 —— 原样 PAUSED ⇒ warn；
伪造成 ACTIVE ⇒ fail；无此类排期的区 ⇒ ok。

同批带上的既有改动：supervise-launch.py 路径相对化 + 三级取值（禁回落 ~）。
 2026-10-14 09:48:01 +08:00
admin d81f75f173 技能包：配置与代码分家 —— 每包自建 env/ 放本机专属配置，scripts/ 不再写死本机路径 
用户 2026-10-11 原话：
· 19:22「这个环境都是针对一台机器的，同步到别的机器把环境都搞坏了」
· 19:28「不用挪出 用env文件夹区分就行，重点是 脚本是脚本 配置是配置」
· 19:29「每个技能 需要环境配置的 都有自己的 env文件夹」
· 19:30「修改完成后要仔细检查 避免调整后 各技能脚本运行失败」

改动：
1、session-mechanism 新增 env/（roots.env＝本机真身不入库 ＋ roots.env.example＝样例入库），
   install.py 的 ROOTS_ENV 改指 env/roots.env；全包脚本/hook 的配置定位统一为
   「向上 4 层 × env/roots.env 优先 → 包根 roots.env 兼容 → 技能库那份兜底」。
2、去硬编码：collabctl / keepalive / supervise-launch / board-launch 里的本机路径与本机工作区
   清单全清，改为 DSH_AIROOT（兜底 dirname(DSH_WS_ROOT)）＋ 扫 <AIROOT>/*/.workbuddy/collab/
   自动发现；保活任务名按 collabd-keepalive-<工作区名> 现推；启动器默认值改 ~/.workbuddy 形态。
3、browser-harness：bh_chrome_keepalive.py 默认值全部改 env 驱动，新增 env/bh.env.example。
4、.gitignore：env/ 下只放行 *.example（三行三种层级）＋ 兜住旧位置的包根 roots.env。
5、改包纪律.md 新增「四、包结构：脚本是脚本，配置是配置」，立为全仓通用规矩。
6、文档同步：SKILL.md / deploy.md（新增 §3b 配置层级、§6 换机器必查 6 件事）/ rules.md /
   pitfalls.md / supervise-persistence.md。

验收（本机）：py_compile 34 个 py 全过；selftest PASS 109 / FAIL 0；
逐文件实证 8 个 loader 命中 env/roots.env；preflight-lock.sh 同目录实测解出两个根；
install.py --manifest 77 份、语法失败 0。

异机验证（包拷成「新克隆」（只有 *.example）＋ 另造假工作区 ws-alpha/ws-beta）：
install.py --apply 自生成该机 env/roots.env；collabctl/keepalive 自动发现的确实是
ws-alpha/ws-beta、任务名现推（写死清单确已消除）；部署副本本地无 roots.env 时靠
CODEBUDDY_CONFIG_DIR 兜底读到技能库那份；整套 selftest 有宿主库时 PASS 108 / FAIL 1
（唯一 FAIL＝该区没有常驻心跳，环境所致；本机常驻在跑时同一套为 PASS 109 / FAIL 0）。
 2026-10-11 21:49:28 +08:00
admin 64dd82073b session-mechanism: 修复钩子静默失效 + 3 处判据缺陷；禁「变相征询」 
1) stop-dialog-guard: session_budget() 早退路径返回 2 值、末尾返回 3 值，调用方按 3 值解包
   ⇒ transcript > 64 MiB 时每轮 ValueError。因 fail-open（异常仍 exit 0），
   宿主零报错、install.py --verify 只判 rc=0 ⇒ 假绿；实测 86 条 EXCEPTION，
   死掉的是整条（水位/收口、接续机制起点、预算告警、门禁自检、路径自检）。

2) session-rules-check 三处判据：
   · hook_reg  按旧文件名找 ⇒ 合并成 prompt-guards.py 后每轮假红 ⇒ 改为一组可接受名
   · snap_sync 拿 mtime 当内容判据 ⇒ 连续 4 天假红 ⇒ 改为复用抽取器本体比对内容
               （变异对照：截断快照能报 fail，非恒绿）
   · mem_ptr   只查全局技能根 ⇒ 工作区自带技能被判悬空 ⇒ 改查「全局 ∪ 工作区」

3) pitfalls 新增 P0-95（改判据必须重跑变异对照；fail-open + 只看 rc=0 = 假绿温床）

4) 回复排版核心块新增「变相征询同样禁止」（先只报不动／等你发话／我倾向X你看呢
   这类不带选项的待定清单，一律按待拍板项写：问题＋说明＋各候选优缺点＋倾向）
 2026-10-06 22:27:03 +08:00
admin 19101acd65 init: workbuddy_skills 重建，仅收录 session-mechanism 
- 按用户指示清空原有 25 技能内容，只提交 session-mechanism（57 文件）
- 附 .gitignore（产物 + 本机凭据）
- 令牌明文已脱敏（历史 .neodata_token 与 pitfalls 引用均不入库）
- 本提交为孤儿提交（父提交为空），历史自此重新开始
 2026-10-05 14:13:24 +08:00