5 Commits

Author	SHA1	Message	Date
wandering1	4a4ad6bc5f	chore(全仓): @build/@test 旧文档别名清退为技能调用名 ... 现状口径：/keil-build 与 /serial-boot-test 是 DSH 会话的技能调用名， 不是 shell 命令；「名 + 命令行参数」的命令形态改为可执行体 run_boot_test.py 的真实调用。 - AGENTS.md：别名说明重写为「技能调用名不是 shell 命令」，两条目改 「编译（/keil-build）」「串口回归（/serial-boot-test）」 - keil-build / serial-boot-test 两 skill 调用名与示例同步；task-worktree 方案文档去掉 @build/@test 惯例从句；@task 保留（不在点名范围） - 123 文件现状陈述全改；台架捕获、变更记录/时间线、rename 映射输入 等 41 行历史证据保留旧名 - gen_memory_svg.py 6 处措辞随改，3 张 SVG 产物同批重跑 - 顺手补并行方案同行漏网计数 51→52 钩子 验证：提交期快钩子对 123 文件实跑全 Passed；check_doc_links --all rc=0（3038 处、无法判定 0）；check_mermaid --all rc=0；YAML 解析 52 钩子不变；skill-size rc=0；py_compile 全过；字节卫生零漂移。	2026-10-30 13:03:12 +08:00
wandering1	2be49dc9dd	docs(skills): 明确 @build/@test/@task 为文档别名并新增 precheck/postmerge 命令 ... AGENTS.md「构建与验证」新增总口径：@build / @test / @task 都是本仓库的 文档别名、不是 shell 命令（2026-10-30 实测：bash 敲 @task / @build 即 command not found，dsh task 被解析成 profile 名报错）；`=` 后的命令行 才是可执行形态，DSH 会话显式调用为 /keil-build、/serial-boot-test、 /task-worktree。 - AGENTS.md / docs/README.md / 并行任务工作树方案.md：@task 三处定义位 由「短命令」统一改为「文档别名」，并写入两种实测失败形态 - keil-build / serial-boot-test SKILL.md：定义位点破别名性质；@test 在 skill 内原先没有定义句，补口径 blockquote - task-worktree SKILL.md 与 reference/：whenToUse、标题、症状表、插件桥 去 @task 前缀改指 list / 本 skill；frontmatter 能力清单同步 - task_worktree.py 新增 precheck（树内只读自查：BOM 漂移 / CR / U+FFFD、 docs 逐档门禁、--msgfile 消息 BOM/CRLF/行长/禁词检查，自动补 ci-artifacts/）与 postmerge（主树体积凭证自动诊断：新鲜跳过、红先短链 再只读复检裁定是否升全链；check_doc_links --all；列文件不代提交） - done 快路径打印与门禁拦截提示均指向 postmerge 实测：precheck 对坏消息文件抓到 CRLF、行长 95>80、禁词×3（rc=1）； postmerge 端到端「凭证同码新鲜→跳链→doc --all 绿（2967 章节引用 / 214 文档）→列 dirty 文件」rc=0；check_skill_size.py 与 py_compile 通过； frontmatter 改动后 DSH 已用新值真加载过一轮。无 .c/.h 改动，不涉及体积。	2026-10-30 10:25:05 +08:00
wandering1	2b478588a7	docs(task-worktree skill): 补「只改注释也刷红体积同码凭证」实测坑 ... done testdoc 撞上的一次新型红：size-gate 的判据是索引 blob 指纹，不是体积数字。 全库路径同步顺带改了 20 个 .c/.h 的注释，Program Size 逐项没变，凭证照样报 「不同码」。处置比 C 节补绿链短：合并后 done 自己那次 @build 已 0 错 0 警， 只需 ram_baseline.py --update 重写 scripts/size_attestation.json， 不 --write 动内存受管快照（数字没变就去改受管区＝给别的在飞分支造冲突面）。 连带登记第二个坑：done 在「分支已合入」的路径上于门禁之前就 return， 补完凭证重跑不会替你复绿，落主干后的全量证据要自己跑 ci_local.py （实测 47 runner / 3896 断言全绿）与主树 check_doc_links.py --all （实测 215 个文档 / 2993 处章节引用 rc=0）。 只加 reference/pitfalls.md 一条，SKILL.md 正文一字未动（受插件写侧 65536 字节上限，深规程一律进 reference/）。	2026-10-30 09:14:49 +08:00
wandering1	ecf9d3ad3d	docs(task-worktree skill): 修 @T3@ 围栏腐坏，正文瘦身并把细节外置 reference/ ... 围栏腐坏是真 bug：@T3@ 是被误提交进仓的代码围栏占位符，Markdown 渲染出 来就是一行 @T3@ 加裸命令。git log -S 定位：842d711e（2026-10-28） SKILL.md 还有 18 个真三反引号围栏行、0 个占位符；21c68521（2026-10-29 插件桥接那笔）起变 0 围栏 / 34 个占位符。全仓只有本技能 6 个文件有此 病，draw-diagram / keil-build / ui-verify 等都用真围栏。本轮七个文件 占位符清零、围栏全部成对。 信息密度：SKILL.md 28,139 → 23,087 B（−18%，占插件写侧上限 65536 的 35%，给自进化留头量）。同一句外置理由在 C2/D/E/F/G/陷阱/验证 重复 7 次 → 0；frontmatter 与 F 节写了两遍的插件桥接说明收进 F 节；「这不是免费 的」「挡给你看的保护」这类修辞删掉。删掉的细节全部落进对应 reference 篇——skill-size 钩子会校验指针不悬空：现 26 处链接 / 8 篇目标 / 悬空 0， 每篇都有入口。 锚点未重排：节号 A–G/C2、各节步骤号、铁律编号被 reference/ 反向引用 （铁律 3/5/7/9 与 A 第 1、5 步，C 第 5~7 步，E 第 1~6 步均结构性存在）。 只在 SKILL.md 出现的 PIPESTATUS 教训保留（reference/ 里没有，删了就丢）。 门禁：check_skill_size.py rc=0（17 个 SKILL.md 全在写侧上限内、无悬空 指针）；七文件均无 BOM / CR / U+FFFD、单个尾换行。	2026-10-30 00:31:36 +08:00
wandering1	f08b12a46c	docs(技能渐进展开): 五个技能正文逐字外置到 reference/，主文只留索引与指针 ... 按「主文留头量、深规程外置」重写本仓技能，全部是逐字搬移： 搬移前断言原文每条非空行必须出现在新主文或 reference 文件里， 0 丢失才落盘；步骤编号一律不重排（正文有「第 12 步」交叉引用）； 每个切点保留原小标题 + 索引（加粗引导句与步骤标题）+ 指针行。 主文变化（上限口径 = 插件写侧 65536 字节，见上一笔 skill-size 钩子）： - id-family-semantic-migration 33392 -> 10968（17%），reference 3 篇 - stale-doc-count-sweep 19811 -> 6945（11%），reference 2 篇 - mem-budget 19963 -> 13042（19%），reference 3 篇 - keil-build 12917 -> 8879（14%），reference 2 篇 - task-worktree 72601 -> 28139（42%），reference 8 篇 task-worktree 本笔同时收录另一会话已写完的 C2/D/G 三节正文——那 三处手改与我的拆分落在同一份文件改动里，不可分离；其内容同样已 随 reference/ 外置，主文只剩标题、索引与指针。 外置语料合计 122211 字节 / 30 篇：围栏数逐篇为偶，无 BOM/CR/U+FFFD。 draw-diagram 与 serial-boot-test 脚本是另一会话的在飞改动，本笔未含。 skill-size 钩子在本笔首次真跑（前一笔无 .dsh/skills 文件可触发）。 gate: pre-commit 全绿（doc-links、id-check-new、check-yaml、 skill-size、check-added-large-files）；30 篇 reference 手工字节 体检 clean；skill() 逐个复载确认加载的是拆分版。	2026-10-29 15:03:12 +08:00