Imported from zsxink/skills-hub (
skills/handbook-code/SKILL.md). Install upstream withnpx skills add zsxink/skills-hub --skill handbook-code. Copyright stays with the author.
name: handbook-code 当用户需要在正文中插入可复制、带中文注释、可核证的代码/命令教具时调用（由 handbook-paper-writer 在 ④ 写作关、draft 遇代码点时调度）；产出 chapter_draft 内的带注释代码/命令块（含真实输出与结论）。
代码+双栏注释（handbook-code）
产出可复制、带中文注释、可核证的代码 / 命令块，作为正文的教具与证据。
唤醒条件
主技能在 ④ 写作关，draft 遇到要贴代码 / 命令时唤醒。
输入
- chapter_draft 中需要代码支撑的点 + research_pack 的真实样本
输出
- 带注释代码块（并入 chapter_draft 或独立 code_block.md）。
引用原子（见 references/kernel_skills.md）
本技能拥有并应用以下原子：
| K | 名称 | 维度 |
|---|---|---|
| K28 | 代码与命令块＝可复制教具＋可核证物 | 视觉 |
被检查门禁
本技能自身校验其拥有的视觉原子（K28 → handbook-code），无独立门禁；以「可复制 + 带注释 + 带真实输出」三项完成判定为准（见原子字典）。
完成判定
- - [ ] 代码读者能直接复制用（真实成品，非干代码）
- - [ ] 每段配中文注释讲「这段在防什么 / 做什么」
- - [ ] 关键行做指认式解读（「中间那行 const matches 是判断汉字的」）
- - [ ] 证据块带真实路径 / PR 号 / 版本号 + 你这一跑的真实输出 + 一句结论
做法步骤
-
- 贴代码前问「读者能直接复制用吗」，不能就换成最小可用成品（SKILL.md / hooks JSON / 安装命令 / 目录树）。
-
- 每段代码配一句中文注释讲它在防什么，挑一行做指认式解读并明说「不写代码也能看出」。
-
- 证据类片段带真实路径 / PR 号 / 版本号，声明有没有改动过。
-
- 每个命令块后必须紧跟「我这一跑打出来是 X」的真实输出 + 一句结论；给不出输出的命令不贴。
反例
-
- ❌ 贴一段省略号满满的「示意」代码。
-
- ✅ 贴完整 SKILL.md，逐字段讲 name/description，「就这么简单」。
-
- ❌ 命令块只写命令不写输出。
-
- ✅「方式就两条命令，你现在跑一遍也是同样的东西……我这一跑打出来是 4100 25。」
