@huicai/cli 2026.814.0 → 2026.1021.0

package/skills/docx-author/trigger-cases.json

@@ -0,0 +1,58 @@
+{
+  "skill": "docx-author",
+  "purpose": "触发行为规格。CI 按词法跑：正样例须在描述词汇上明显压过近似负样例，且路由到自己。改 description 后必须重跑 skill-lint route。",
+  "intentionalOverlap": [
+    "tech-doc",
+    "gov-document",
+    "doc-compare"
+  ],
+  "cases": [
+    {
+      "id": "pos-word",
+      "prompt": "帮我写个 Word 报告",
+      "shouldTrigger": true,
+      "lexical": false,
+      "why": "「写个 Word 报告」在党政/企事业语境下也可能指公文里的「报告」文种，gov-document 的描述更短因而词法分更高。真正的分辨点是上下文（是不是红头、有没有主送机关），词法层天然无能为力——按 skill-lint 的规则交行为层，不往描述里塞噪声词去拉分。"
+    },
+    {
+      "id": "pos-word-doc",
+      "prompt": "生成 Word 说明书文档，要带目录和页码",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-docx",
+      "prompt": "生成一份 docx 方案文档",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-doc-layout",
+      "prompt": "Word 文档排版有问题，帮我检查格式",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-proofread",
+      "prompt": "校对文档，检查错别字和标点",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-ai-flavor",
+      "prompt": "文档 AI 味太重，帮我去掉套话",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-ppt",
+      "prompt": "做一份 PPT 汇报材料",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-excel",
+      "prompt": "把这张表做成透视表",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-code",
+      "prompt": "帮我审一下这段代码",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/echo-brief/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: echo-brief
+description: 口述回声契约——用户一大段意识流输入（语音转写、长段吐槽、连写带改的需求）到手后，先回一份结构化「回声简报」让用户核对，核对通过前不动手。当输入是弱标点的长段自述、含中途改主意（"算了不要这个"）、以「我说一下想法/口述/语音转的」开头、或用户说"帮我理一理/我先说说"时使用。
+version: 1.0.0
+---
+
+# 口述回声契约
+
+一段十分钟的口述比任何人愿意打字的提示词都携带更多上下文。问题不在接收，在**接收之后**：
+模型会把每一处空白都自信地填上。「用那个常用的模型」悄悄变成某个具体模型，
+「按标准尺寸」变成某个具体数值，用户中途否掉的方案作为事实活了下来。
+这些在模型内部都不表现为不确定，因此永远不会变成一个澄清问题。
+等发现时，往往已经是一小时的产出之后。
+
+**追问只能验证模型怀疑的部分；回声能验证模型相信的部分。** 这是本技能存在的全部理由。
+
+## 何时使用
+
+- 输入是长段、弱标点、有重启与自我修正的意识流（典型来自语音转写）
+- 开头带口述前缀：「我说一下」「口述一下」「语音转的，可能有错别字」
+- 中途出现立场反转：「算了」「不对，刚才说的作废」「还是用原来那个」
+- 用户明确说「先别动手，我把想法说完」「帮我理一理」
+
+## 何时不用
+
+- 已经清楚的短请求（回声只会显得啰嗦）
+- 用户要的是逐字整理/会议纪要——那是保留原话，不是重构意图
+- 已经结构化的长文本（贴进来的规格文档、需求文档）
+- 用户问了一个直接问题，要的是直接答案
+
+## 六条契约
+
+1. **核对通过前不动手。** 不改文件、不写代码、不出方案、不对碎片抢答。
+2. **凡是我补的，单独列。** 推断与猜测放进独立小节，绝不混进用户自己的话里。
+3. **每一处反转都要说出来。** 采纳后一个立场，但把反转本身标出来；不许悄悄取平均或替用户选。
+4. **一条都不能丢。** 跑题的内容归入「搁置」，不是删掉。
+5. **绝不点评口述痕迹。** 错别字、同音字、语气词、重启，一律按上下文静默还原。保留用户自己的用词与项目代号。
+6. **落盘要问。** 核对通过的简报可以存档，但不能不问就存。
+
+## 回声简报的结构
+
+一次回复，五节，密到能几秒扫完（完整模板与范例见 [references/echo-format.md](references/echo-format.md)）：
+
+1. **目标** — 一句话说清用户真正想达成什么。常与他最先说的那句不同，这很正常。
+2. **已定** — 用户已经拍板的决定与约束，合成一张清单。他强调过是重点的，标出来。
+3. **待定** — 口述里提起但没给答案的问题。
+4. **台账** — 反转（两个立场写一行，注明采纳后者）与搁置的支线（各一行）。
+5. **我补的** — 唯一的解释性小节。分「推断」（强烈暗示但没明说）与「猜测」（我填的空）。**告诉用户优先核对这一节。**
+
+三条压缩纪律，破了简报就没人看：
+
+- **同一件事只出现一次。** 每个事实只属于一个小节。
+- **不要复述。** 除「我补的」之外，其余内容按定义都是用户自己说的，不必加「你说」。
+- **一条一行。** 一条要写两行，那它就是两条，或者是废话。
+- **模糊量词绝不静默消解。** 「常用的那个」「标准尺寸」「尽快」——要么进「待定」，要么进「猜测」，不许当成已定条件吸收掉。
+
+结尾邀请纠正，并提出可选的追问。
+
+## 追问（可选）
+
+追问有它的位置：在回声**之后**，不是代替回声。仅当用户接受邀请或一开始就要求被访谈时进行。
+
+- 只问「待定」与「猜测」里的条目
+- 一次一个问题，信息增益高的先问
+- 每个问题用一个从句说明「为什么这件事要紧」
+- 最多五个；答案不再改变简报时提前停止
+- 访谈结束后，只重述发生变化的那几节
+
+## 语音场景的额外一条
+
+语音输入的错误容忍度比打字低得多：听错一个字可能执行错一个动作，而用户往往不会逐字复核转写结果。
+所以当输入标记为语音来源时，**回声简报不是可选项**——哪怕内容看起来很清楚，也要先回声再动手。
+转写里明显的同音字错误按上下文静默改正，但若改正会改变动作对象（人名、文件名、金额、命令），
+把它放进「我补的 · 猜测」里让用户确认。
+
+## 落盘
+
+用户确认后，给出三个选择，不要替他决定：
+
+1. 追加到 CLAUDE.md / HUICAI.md，让后续会话继承
+2. 存到 `docs/rambles/YYYY-MM-DD-<主题>.md`
+3. 只留在本次对话里
+
+确认后的简报即成为本次会话的约束：其中的决定与限制不再重复询问。

package/skills/echo-brief/references/echo-format.md

@@ -0,0 +1,68 @@
+# 回声简报模板与范例
+
+## 模板
+
+```
+**目标**：<一句话>
+
+**已定**
+- <决定或约束>
+- <决定或约束>  ⭐<用户强调过是重点的加星>
+
+**待定**
+- <口述提到但没答案的问题>
+
+**台账**
+- 反转：<先前立场> → <后来立场>（采纳后者）
+- 搁置：<跑题但值得记的支线>
+
+**我补的**（请优先核对这一节）
+- 推断：<强烈暗示但没明说的>
+- 猜测：<我填的空>
+
+以上有出入的地方直接说，我改。要我就「待定」里的问题逐个问一遍吗？
+```
+
+## 范例
+
+用户口述（语音转写，弱标点、有反转）：
+
+> 那个我们那个后台的导出功能吧现在有问题就是数据量一大就超时了 用户点了没反应
+> 得改成异步的 就是点了之后先返回一个任务号 然后后台慢慢跑 跑完了发个通知
+> 哦对通知就用站内信吧 不要发邮件了 之前说邮件是因为怕漏但是邮件太吵了
+> 然后那个导出格式还是用常用的那个 表格那个 嗯还有就是这个要尽快因为下周要给客户演示
+
+回声：
+
+```
+**目标**：把后台导出改成异步任务，解决大数据量超时导致的「点了没反应」。
+
+**已定**
+- 导出改异步：点击后立即返回任务号，后台执行
+- 完成后通知用户
+- 通知渠道用站内信 ⭐
+- 明确不发邮件（太吵）
+
+**待定**
+- 「尽快」具体是哪天？（下周要给客户演示，是演示前几天要可用？）
+- 任务号给用户之后，他从哪里看进度与结果？
+- 超时的现有阈值是多少、大数据量的量级是多少行？
+
+**台账**
+- 反转：通知走邮件（怕漏） → 走站内信（邮件太吵），采纳后者
+
+**我补的**（请优先核对这一节）
+- 推断：「点了没反应」指的是前端等待同步响应直到超时，不是按钮无响应
+- 猜测：导出格式「常用的那个 表格那个」我理解为 Excel（.xlsx）；也可能你指的是 CSV
+- 猜测：「发个通知」指任务完成时通知，失败时是否也要通知没有说
+
+以上有出入的地方直接说，我改。要我就「待定」里的问题逐个问一遍吗？
+```
+
+## 这份范例里值得注意的几处
+
+- **目标不是他最先说的那句。** 他先说的是「导出功能有问题」，真正的目标是「改成异步」。
+- **「常用的那个 表格那个」没有被静默解析成 Excel。** 它进了「猜测」，因为猜错的代价是整个导出格式做错。
+- **「尽快」没有被当成已定条件。** 它进了「待定」——「尽快」不是一个日期。
+- **反转被写出来了，而不是只留下站内信。** 用户能看到自己改过主意，也能反悔回去。
+- **「哦对」「嗯」「就是」全部静默去掉，没有一句评论。** 用户的用词（「站内信」「任务号」）原样保留。

package/skills/echo-brief/trigger-cases.json

@@ -0,0 +1,40 @@
+{
+  "skill": "echo-brief",
+  "purpose": "触发行为规格。负样例分两类：**不同词汇**的近邻走词法层（CI 跑），**同词汇不同意图**的近邻标 lexical:false 归行为层——词法打分对后者天然无能为力，硬要它通过只会逼作者往描述里塞噪声词。",
+  "cases": [
+    {
+      "id": "voice-prefix",
+      "prompt": "语音转的可能有错别字，我说一下想法：这个导出功能现在是同步的，用户点了要等，改成异步吧，弹个进度条，算了进度条太重，给个转圈就行",
+      "shouldTrigger": true
+    },
+    {
+      "id": "dictation-declared",
+      "prompt": "我口述一下需求，你先别动手，等我说完",
+      "shouldTrigger": true
+    },
+    {
+      "id": "help-me-sort-out",
+      "prompt": "我先说说，你帮我理一理这段思路",
+      "shouldTrigger": true
+    },
+    {
+      "id": "near-miss-meeting-minutes",
+      "prompt": "把这段录音整理成会议纪要，逐字保留原话",
+      "shouldTrigger": false,
+      "lexical": false,
+      "note": "与口述场景共用「录音/这段/整理」——同词汇不同意图：纪要要的是保留原话，回声要的是重构意图。词法层分不开，归行为层。"
+    },
+    {
+      "id": "near-miss-short-command",
+      "prompt": "把这段导出改成异步",
+      "shouldTrigger": false,
+      "lexical": false,
+      "note": "同样可能来自语音，但短指令一眼能核对，回声只会显得啰嗦。长短之别不在词汇里，词法层分不开。"
+    },
+    {
+      "id": "near-miss-direct-question",
+      "prompt": "分片表能不能用 COUNT(DISTINCT)",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ecommerce-ops/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ecommerce-ops",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "GMV 拆解归因怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "大促复盘和售罄率分析",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "直播投放效率和评价挖掘",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次门店零售的排班",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份供应链库存计划",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/education-training/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "education-training",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "设计一门课，教案讲义怎么写",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "企业内训方案和题库怎么出",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "培训效果怎么评估",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份学术论文",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次员工绩效面谈方案",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/ehs-safety/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "ehs-safety",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "安全检查隐患排查怎么闭环",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "动火和受限空间作业许可怎么办",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "危险源辨识用 JSA 还是 LEC，安全事故怎么调查",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次设备点检保养计划",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份质量体系文件",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/email-writing/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "email-writing",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "帮我写封邮件催一下对方",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "这封回复怎么措辞比较得体",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "写一封英文商务信函，跨部门协调",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一篇公众号推文",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次客诉升级话术",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-ai/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-ai",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "要给产品加 AI 能力，不确定用哪条 ai 链",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "LLM 特性立项，效果和成本怎么控",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "AI 效果劣化了，从哪查起",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次模型微调的数据准备",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段前端埋点代码",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-architecture/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-architecture",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "新系统方案要做容量估算和 C4 分层",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "做技术选型评分卡和 ADR 决策记录",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "架构评审用 ATAM 怎么做，技术债怎么治",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "画一张部署拓扑图",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "设计一个接口的资源建模",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-automation/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-automation",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "研发流程提效立项，重复劳动怎么清点",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "机器人和定时例程怎么建，自愈动作要不要上",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "自动化脚本失控了，自动化债怎么治",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "搭一条 CI 流水线做缓存优化",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一个办公文件批处理脚本",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-collaboration/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-collaboration",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "代码评审老拖沓，SLA 怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "知识都在一个人脑里，巴士系数怎么盘",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "跨团队扯皮，技术分歧怎么处理",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份新人入职培训课程",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次会议纪要整理",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-complex-env/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-complex-env",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "要进受限网络作业，进场侦察清单有哪些",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "低权限审批制生产环境，长任务怎么断点续作",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "目标环境等价验证和降级 PlanB 怎么排",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次容器化改造",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份灾备演练方案",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-data-platform/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-data-platform",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "建数仓分层，ODS DWD DWS 怎么划",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "ETL 管道幂等和增量口径怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "调度 DAG 基线告警，数据延迟事故怎么处置",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次指标口径治理",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段实时作业的窗口逻辑",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-database/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-database",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "存储选型，OLTP 还是时序还是向量库",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "建库建表，索引设计和连接池公式",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "分库分表要不要上，数据库变更怎么灰度",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次慢 SQL 的执行计划分析",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段缓存一致性的代码",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-develop/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: eng-develop
 description: 开发子链总控（领任务→分支→编码→自测→自评→提交 PR 全流程、语言无关编码规范通则、DoD 完成定义、AI 结对纪律;按技术栈路由 13 条孙链:通用工具链/Java/Python/C#/前端/Node/Go/Rust/C++/移动端/跨端/鸿蒙/PHP）。工程链开发环节入口:动手写码前、跨语言协作、不确定用哪条语言链时载入。
-version: 1.0.0
+version: 1.1.0
 ---
 
 # 开发子链总控
@@ -9,6 +9,14 @@ version: 1.0.0
 engineering-chain 的开发环节子链,也是 12 条语言/工具孙链的路由入口。
 输入:验收标准(eng-requirements)+方案与落点(eng-architecture);产出:可评审的 PR。
 
+## 编码前分析与真实验证（四端统一）
+
+任何代码正式编写前，必须通读相关源码、调用方和被调用方、项目规范/约定/文档、已有测试以及需求中的表格和图片；必要时先分析全库。搜索只用来定位，不能把片段当成完整上下文。用现有解析或视觉工具读取附件，缺失或读不懂的材料明确记录，禁止凭空假定。
+
+先读 [工程分析与验证流程](references/engineering-workflow.md)。用 `engineering_plan` 登记已读材料、调用链、改动文件与分项验收命令，再修改；shell、脚本、自动修复和 MCP 写入也遵守此流程。无需另行请用户批准常规计划。
+
+修改后必须运行单测、真实启动项目、冒烟及受影响接口/功能测试。涉及客户端（含共享核心改动）必须在真实宿主或设备模拟器执行交互测试；每项通过 `engineering_verify` 留下实际结果。构建、mock、DOM 单测、浏览器视口模拟均不能冒充原生客户端验收。缺环境时报告未验证及原因，不得宣称完成。
+
 ## 语言/工具孙链路由表
 
 | 技术栈 | 孙链 | 一句定位 |

package/skills/eng-develop/references/dod-checklist.md

@@ -4,6 +4,9 @@
 
 - [ ] 功能过全部验收标准(对着 story-templates 的 Gherkin 逐条勾)
 - [ ] 新逻辑有单测且全绿;关键路径先写失败用例再实现
+- [ ] 编码前已通读上下文/调用链/规范/文档/附件并登记分析与验收计划
+- [ ] 真实启动、冒烟、涉及接口与功能逐项验证，结果对应最后一次改动
+- [ ] 客户端在真实宿主或设备模拟器内完成交互验证，记录环境和证据；未验证项如实列出
 - [ ] 静态检查零新增告警;格式化通过(工具管,评审不吵空格)
 - [ ] 涉接口:契约文档已更新(api-design 同源)
 - [ ] 涉配置/部署:变更说明已写(部署说明进 PR 描述)