@huicai/cli 2026.814.0 → 2026.1019.0

package/skills/dev-mobile/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "dev-mobile",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "Android 启动优化和包体积审计",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "iOS 上架合规整改，权限与隐私怎么过",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "崩溃率红线，符号表和热修怎么管",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次微信小程序的选型",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段前端路由权限",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/dev-node/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "dev-node",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "Node 服务 OOMKilled，内存泄漏怎么排",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "事件循环阻塞，接口卡顿怎么定位",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "NestJS 还是 Fastify，BFF 怎么定位",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一段前端组件的状态管理",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次 Python 环境依赖治理",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/dev-php/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "dev-php",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "PHP 5.x 升到 8，rector 怎么用",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "FPM 调参和慢日志怎么看，OPcache 要不要开",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "Laravel Eloquent N+1 和反序列化安全",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次 Java 依赖冲突仲裁",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段 Node 的流处理",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/dev-python/SKILL.md

@@ -75,6 +75,27 @@ cProfile 找热点函数(配 snakeviz 可视化);**py-spy 生产可用**(无侵
 
 **作业包**:`scripts/venv-doctor.sh`(解释器身份/venv 状态/镜像源/锁文件纪律/同名遮蔽等坑位一键体检)。
 
+## 机器自查（别只靠记忆过这张自查单）
+
+上面「常见坑 TOP」「asyncio 判据」「pandas 性能」里的大半条目已经做成机器规则：
+
+```
+code_inspect(path)                     # 语言陷阱 + pandas + 安全，一次过
+run_tests(path)                        # 跑测试并解析出「失败在哪、期望什么、实际什么、对应哪行业务代码」
+run_tests(path, filter="…")            # 只跑相关用例，定位问题时比全量快得多
+code_inspect(path, only="framework")   # 只看 pandas 用法
+test_plan(path)                        # 补单测前先算清该测几条路、边界在哪
+```
+
+机器能查的：可变默认参数 · 类属性共享可变 · 闭包晚绑定 · `is` 比字面量 · 裸/宽 except ·
+`except` 顺序错（子类分支永不执行）· `raise` 不带 from · 遍历时增删容器 · 遮蔽内置名 ·
+生产代码用 assert · `open()` 无 encoding · naive datetime · `Decimal(浮点)` ·
+`os.path.join` 吞前缀 · async 里混同步库 · pandas 链式赋值/无 dtype/append/iterrows/inplace ·
+`shell=True` · `yaml.load` · `pickle.loads`。
+
+机器查不了、仍要人看的：GIL 与多进程/多线程的选型是否正确、循环 import 是不是分层问题、
+`chunksize` 与换引擎（polars/duckdb）的临界点、fixture 作用域是否恰当。**这几项评审时重点看。**
+
 ## 使用纪律
 
 无锁定文件不部署;脚本三无(无日志/无参数/无退出码)不上生产;

package/skills/dev-python/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "dev-python",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "Python 环境依赖混乱，uv 和 pyproject 怎么治",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "pandas 向量化怎么写，cProfile 怎么用",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "用 py-spy 做性能画像，脚本怎么上生产",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一段 Go 的错误处理",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次前端构建缓存优化",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/dev-rust/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "dev-rust",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "Rust 借用检查斗不过，所有权怎么理",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "tokio 异步取消安全和持锁 await 怎么办",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "thiserror 和 anyhow 怎么分工，unsafe 怎么最小化",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一段 C++ 智能指针代码",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次 Go 的 goroutine 泄漏排查",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/dev-toolchain/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "dev-toolchain",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "配新开发环境，Git 工作流和提交粒度怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "pre-commit 门禁和 Lint Format 怎么统一",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "包管理私服和国内镜像怎么配",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份规范的提交信息",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次 CI 流水线的缓存优化",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/doc-chain/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "doc-chain",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "30 页报告从调研到定稿，整条链怎么走",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "要写正式文档但文体还没定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "多人协作写长文档，怎么分章合成评审",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "帮我写个会议纪要",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次合同版本比对",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/doc-compare/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "doc-compare",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "比对两份文档，看改了哪里",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "和范本差在哪，出个红线版",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "多方案差异表怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "帮我写一份 Word 方案",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次代码 diff 的评审",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/docx-author/SKILL.md

@@ -1,39 +1,141 @@
 ---
 name: docx-author
-description: 编写/生成 Word 文档（报告、周报、方案、纪要、总结）。当用户说"写个文档/Word/docx/报告/方案/会议纪要"且期望文件产物时使用。
-version: 1.0.0
+description: 生成与校对 Word 文档（.docx）：Word 报告、Word 方案、说明书、总结、纪要、任务书、验收材料。当用户说"写个文档/Word/docx/报告/方案/说明书"且期望文件产物，或说"文档排版有问题/文档格式检查/文档校对/错别字/标点混用/图表编号/段落缩进/文档 AI 味太重要去套话"时使用。生成走 create_doc（版心、字号、行距、缩进、表格列宽、插图比例、图表题注编号全由引擎算），校对走 docx_inspect（结构·排版·表格·插图·文字·AI 味·一致性七类体检，可自动校正另存）。
+version: 2.0.0
 ---
 
-# Word 文档生成（经 run_python 执行，python-docx 已随托管运行时就绪）
+# Word 文档生成与文档体检
 
-## 流程
+**Word 的排版事故不是审美问题，是一致性问题。** PPT 出事你一眼看得见（文字出框、图片变长脸）；
+Word 出事要翻到第 18 页才发现：这一段缩进了下一段没缩、正文混着三种字号、图表编号跳了号、
+表格宽出版心右边一列打印时被裁掉、通篇「有效提升」却没有一个数字。
+这些在保存时都不报错，屏幕上也不刺眼——等评审专家翻到那一页才现形。
 
-1. **大纲先行**：先在回复里给出章节大纲（标题层级 + 每节要点），重要文档让用户确认再落盘。
-2. **内容走 Markdown 中转（防截断的关键）**：
-   - 用 write_file（长文加 `append=true` 分段）把全文写成 `草稿.md`——结构约定：`#`/`##`/`###` 标题、`-` 列表、`1.` 有序列表、`|` 表格、`**粗体**`、普通行=正文段落；
-   - `read_skill_file` 读本技能 `scripts/docx_doc.py`，执行 `md_to_docx('草稿.md', '产物.docx', title=..., author=...)` 一次转出成品——封面、目录域、页眉页脚页码、中文字体、标题样式全自动。
-   - 内容不长（<200 行）可跳过中转，直接在代码里用 helper 逐节构建。
-3. **验收（必做）**：`verify('产物.docx')` 重开打印标题树/段落数/表格数，并对照大纲检查无缺节。
+所以本技能两件事：**排版不由你算，出稿后再机检一遍。**
 
-## 样式约定（docx_doc.py 已内置，别再手搓）
+## 一、生成：用 `create_doc`，不要自己写 python-docx
 
-- 中文字体：正文宋体、标题黑体（west=Calibri），经 `w:eastAsia` 正确设置——只设 `font.name` 中文不生效是最常见的坑。
-- 目录：插入的是 TOC **域**，首次打开 Word 会提示按 F9 更新——在文末提示用户这一点，不要伪造静态目录。
-- 页码：页脚"第 X 页 共 Y 页"域。
-- 表格：默认 `Table Grid` 网格样式 + 表头加粗。
+`create_doc(path, spec)` 是首选路径。你只给「哪一节写什么」，引擎负责所有尺寸：
 
-## 分析/总结既有文档
+```jsonc
+{ "template": "研发任务书", "title": "智能运维平台研发任务书", "org": "数字技术研究院",
+  "doc_no": "YF〔2026〕14 号", "header": "智能运维平台研发任务书", "footer": "数字技术研究院",
+  "blocks": [
+    { "type": "h1", "text": "任务来源与依据" },
+    { "type": "p",  "text": "依据院发〔2026〕3 号与合同 HT-2026-014 号下达。" },
+    { "type": "h1", "text": "技术指标" },
+    { "type": "p",  "text": "强制性指标如表 1 所示，以第三方检测报告为准。" },
+    { "type": "table", "caption": "技术指标与判定依据",
+      "rows": [["指标","档次","指标值","测试方法","判定依据"],
+               ["平均故障发现时间","强制","≤ 8 分钟","连续 30 天生产采样","检测报告"]],
+      "note": "口径以合同附件三为准" },
+    { "type": "kv", "caption": "交付物清单",
+      "pairs": [["软件安装包","V1.0.0，光盘 2 份"], ["源代码","Git 全量归档 1 份"]] },
+    { "type": "figure", "image": "diagrams/arch.png", "caption": "总体架构" },
+    { "type": "signature", "roles": ["编制","审核","批准"], "org": "数字技术研究院" }
+  ]}
+```
 
-- 读别人给的 docx/pdf：优先 `read_document`（平台解析，支持超长分段通读）；要精确到表格结构时再用 python-docx 遍历 `doc.tables`。
-- "总结成周报/纪要"类任务：先通读原文并列要点（在回复中），确认口径后再生成 docx。
+**块类型**：h1–h4 标题（自动编号）/ p 正文 / bullets 无序 / ordered 有序 /
+table 表格（题注在表**上**）/ kv 表单式两列表 / figure 插图（题注在图**下**）/
+note 小字注 / signature 签字栏 / pagebreak 分页。
 
-## 验收自查
+**三档规范** `profile`：`tech` 技术文档（默认，A4·宋体小四·1.5 倍行距·首行缩进 2 字符）/
+`gov` 党政机关公文 GB/T 9704（仿宋三号·固定行距·每面 22 行）/
+`report` 科技报告·学术（固定 20 磅行距·十进制编号 1、1.1、1.1.1·图表按章编号）。
+传 `template`（十七类研发文档，见 [tech-doc](../tech-doc/SKILL.md)）会自动选档位，
+并**核对必备章节、缺哪节直接报出来**。
 
-- [ ] 大纲与成品章节一一对应（verify 输出的标题树 print 过）
-- [ ] 目录域/页码已插入，且已提醒用户 Word 内按 F9 刷新目录
-- [ ] 中文在 Word 中字体正确（用了 helper 而非裸 add_paragraph）
-- [ ] 长文档没有因为单次工具参数过长被截断（走了 md 中转）
+引擎自动做完这些，不要自己再做一遍：封面 / 目录域 / 页眉页脚 / 页码（正文另起一节从第 1 页重算）/
+标题分级与自动编号 / 首行缩进 / 表格列宽按内容算并压进版心（表头加粗 + 跨页重复标题行）/
+插图等比缩放 / 图表题注自动编号。
 
-## 附件
+### 长文档走 Markdown 中转（防截断的关键）
 
-- `scripts/docx_doc.py` — `md_to_docx()` Markdown→Word 转换（含封面/目录域/页脚页码/中文字体/表格）、`verify()` 重读校验；可直接执行自测
+超过两三千字的文档，别把全文塞进一次工具调用的参数里。先 `write_file`（长文加 `append=true`
+分段）写成 `草稿.md`，再 `create_doc(path=..., markdown_path='草稿.md')` 一次转出成品。
+Markdown 约定：`#`/`##`/`###` 标题、`-` 无序、`1.` 有序、`|` 表格、`![题注](图片)` 插图、
+`> 注` 小字注、`---` 分页；表格上一行写 `表：xxx` 作为表题。
+
+**草稿阶段就 `docx_inspect('草稿.md')` 查一遍文字与 AI 味**——改 Markdown 比改 Word 便宜得多。
+
+### 配图
+
+工程图（架构/流程/时序/数据模型）用 `render_diagram`，数据图表用 `run_python` + matplotlib
+（**先设中文字体**），出 PNG 再引用。Word 对 SVG 支持不稳，一律引 PNG。
+图宽由引擎按版心算，**不要自己指定宽高**——同时给宽和高就是把图拉变形的唯一原因。
+
+## 二、验收：`docx_inspect` 必修项清零才算做完
+
+`create_doc` 已自动体检。用户拿来一份别人写的文档问「排版有没有问题」「帮我校对」，也是这个工具。
+
+| 必修（打印出来就丢人） | 建议（能读，但不专业） | 提示 |
+|---|---|---|
+| 中文字体未生效（只设了西文名） | 正文字号与规范档位不符 | 页边距与档位不一致 |
+| 正文字号不统一、同段多种字号 | 中文字体超过两种 | 标题折行超两行 |
+| 首行缩进忽有忽无、用空格假缩进 | 行距设置混杂、正文误居中 | 段末多余空格 |
+| 标题层级跳级、章节编号断号 | 空章节、连续空段、缺页码 | 缺目录域 |
+| 表格超出版心（右列被裁） | 表头未加粗、长表无跨页重复标题行 | 列数过多、空格率高 |
+| 图片损坏、被拉变形 | 分辨率 <120dpi 发虚、超版心高 | 浮动图片会乱跑 |
+| 图表编号断号、引用了不存在的图表 | 缺题注、图表从未被正文引用 | 题注未居中 |
+| 错别字、重复字、连续标点 | 中英标点混用、括号引号不配对 | 数值区间用了连字符 |
+| — | 套话/黑话密度、段首雷同、段落与章节篇幅异常均匀、通篇缺数字锚点 | 空洞副词密度、破折号口癖 |
+| — | 术语多种拼法、关键数字前后矛盾 | 全文无具体年月 |
+
+`docx_inspect(path, fix=true)` 自动修**可确定性修**的那几类：补中文字体、统一字号、
+真缩进替换假缩进、去多余空段与行尾空格、半角标点转全角、表头加粗与跨页重复、
+表格缩回版心、图片恢复原比例并缩回版心、题注编号重排。
+**另存 `-已校正.docx` 不覆盖原件**，并回报复检结果。
+改内容才能解决的（缺章节、缺数据、套话太多、章节失衡）它会如实说需要人改——**别假装修好了**。
+
+## 三、去 AI 味：体检只负责指出，改要靠这几条
+
+体检报「套话密度偏高」「段落长度异常均匀」时，不是删几个词就完事。真正的做法：
+
+1. **套话直接删，不补替代**。「值得注意的是，交付率提升到 98%」→「交付率提升到 98%」。
+   承接性套话（综上所述/总的来说/由此可见）全文留一处就够。
+2. **空转动词换成具体动作**。「赋能业务闭环」→「把审批从 3 天缩到 4 小时」；
+   「有效提升了效能」→给提升了多少，给不出数字就把这句删掉。
+3. **每段落一个可核对的锚点**：数量、日期、金额、比例、责任人、文号。
+   体检报「通篇缺数字锚点」就是在说这一条。
+4. **篇幅按重要性分配，敢于让某节只有三行**。每节都写得一样长，是模板化最明显的指纹——
+   人写东西天然参差。把核心章节扩到两倍，删掉凑数的段。
+5. **「首先/其次/最后」换成小标题或直接分条**，别用连接词假装有逻辑。
+6. **破折号大部分改成句号另起一句**（这是模型口癖里最显眼的一个）。
+7. **不要每段都以总结句收尾**，也不要每段用同样的方式开头。
+
+诚实优先于漂亮：写不出数据就说「暂无法量化」，遗留问题就列出来。
+评审专家一眼能看出哪些是凑的，凑的那部分只会招来更多提问。
+
+## 四、修改与校对既有文档
+
+- 读别人的 docx/pdf：优先 `read_document`（平台解析，支持超长分段通读）；
+  要精确到表格结构时再用 `run_python` + python-docx 遍历 `doc.tables`。
+- 「帮我改一下这份文档」：先 `docx_inspect` 出体检报告 → 把必修项按类归好告诉用户 →
+  排版类问的是「要不要我直接 fix」，内容类要用户拍板（删哪节、补哪个数据）。
+- 「总结成周报/纪要」：先通读原文并在回复里列要点，确认口径后再生成 docx。
+- 改完**一定重跑一次体检**，并如实报出还剩什么。
+
+## 五、交付自查
+
+- [ ] `docx_inspect` 必修 = 0（做不到就如实说明哪几项需要用户决定）
+- [ ] 章节与确认过的大纲一一对应，没有空壳章节
+- [ ] 图表都有题注、编号连续、正文都引用过（「如图 1 所示」）
+- [ ] 关键数字（总投资/工期/指标值）在全文每处出现都相同
+- [ ] 已提醒用户在 Word 中按 F9 刷新目录（目录是域，不是静态文本）
+- [ ] 文件名是中文描述性名称，已 print 产物清单
+
+## 附件（日常用 `create_doc` / `docx_inspect` 工具即可，不必读源码）
+
+- `scripts/docx_layout.py` — 排版度量内核：三档规范、版心几何、中英文字宽表、折行、
+  表格列宽分配、图片等比、标题与题注编号。**建版与体检共用同一把尺**（用两套尺就会
+  出现「生成端说没事、体检端说超宽」的自相矛盾）。
+- `scripts/docx_build.py` — 建版器：十一种块、先量后画、按模板核对必备章节、`save()` 自带体检。
+  `python docx_build.py --demo 出.docx` 可直接自测。
+- `scripts/docx_check.py` — 体检与自动校正：`inspect()` / `report()` / `fix()`；
+  也可 CLI 跑 `python docx_check.py 报告.docx --fix`。
+- `scripts/zh_prose.py` — 中文文字质量：错别字、易混词、标点、术语一致、**AI 味识别**。
+  只吃纯文本，`python zh_prose.py 草稿.md` 可单独查 Markdown 草稿。
+- `scripts/docx_battery.py` — 压力测试：随机内容 × 三档规范跑几百份断言零事故，
+  **反向造 26 类缺陷验证体检不是瞎子**，再跑 9 项反误报、带 BOM 的 Markdown 不变量与 13 项校正闭环。
+  改了上面任何一个引擎文件，**必须重跑**：`python docx_battery.py 300`。