@huicai/cli 2026.814.0 → 2026.1021.0

package/skills/eng-develop/references/engineering-workflow.md

@@ -0,0 +1,37 @@
+# 从上下文到可运行交付
+
+## 编码前
+
+1. 读取适用的 AGENTS、README、贡献指南、规范、架构文档、依赖清单与启动说明；查看工作区已有改动，不覆盖用户未提交工作。
+2. 用 glob/grep/search_code 建立目录与符号地图；沿入口、调用方、实现、数据模型、外部依赖、异常处理和测试追踪调用链。LSP 可用时查定义与引用，索引缺失明确降级为全文搜索。
+3. 通读将改动的文件及必要上下文，长文件分段读全；接口变动要读所有消费者。表格检查多个 sheet、口径和约束；图片查看设计、标注和状态，不只读文件名。跨模块或边界不明时扩大至全库分析。
+4. 记录需求、验收断言、规范、风险与替代方案；先复现 bug 或运行基线测试。新项目先核实目录、需求素材与运行环境。
+5. `engineering_plan(action="plan")` 提交 summary/callChain/conventions/ux/references/targets/client/checks。已有目标文件必须实际读取；新增目标也登记。扩大改动范围时补读并更新计划，不能让计划成为事后补填的表格。
+
+## 选择工具
+
+优先复用项目已有 lint、类型检查、格式化、构建、测试与 CI。代码体检用 code_inspect；测试设计用 test_plan；单测用 run_tests。只在实际任务需要且环境支持时使用覆盖率、契约测试、属性测试、变异测试、依赖审计和性能剖析，不为工具数量堆依赖。
+
+每个 check 有唯一 id、kind 和明确 expectation；unit 指定 path/framework/filter，其余指定有实际断言且失败非零退出的 command。工程验证在原有权限管线内运行，不能借验证跳过审批或访问生产数据。
+
+## 验证必须分项
+
+| kind | 要证明的事实 |
+|---|---|
+| unit | 新逻辑及回归的实际断言运行通过；0 用例、全跳过或非零退出不算通过 |
+| startup | 本次代码对应进程成功启动且就绪；构建成功、打印版本、起了一个 PID 都不够 |
+| smoke | 真实启动后的核心路径、依赖连通、退出与重启基本可用 |
+| behavior | 变更涉及接口/功能的正常、错误、边界、取消/超时/重试等适用分支，断言响应内容和实际副作用 |
+| client | 真实 Electron/VSCode Extension Host/IDEA JCEF 或 Android/iOS 模拟器内打开、操作并断言；记录宿主/设备、场景和截图或日志 |
+
+一个类别可有多项检查，四端公共代码的 client 检查应覆盖四个宿主。CLI 用真实子进程/PTY 交互。浏览器可覆盖网页响应式和交互，但不是 WebKit/iOS 或原生插件运行证据。mock 用于确定性协议回归，应与真实模型/服务联调结果分开标注。
+
+按 id 调 `engineering_verify`。失败先定位修复，再重跑受影响验证。工具保存实际命令、时间、输出和状态；计划材料或目标文件变化会使旧验证失效。测试数据、端口、账号配置隔离，只清理自己启动的进程，不关闭用户既有应用。
+
+台账验证的是执行事实，不自动判断命令是否覆盖了全部需求。必须人工或模型复核断言质量，禁止用 echo、true、--help、构建脚本充当功能验证。任意 shell/MCP 在计划外写入仍需主动补充 targets 和验证；不能把工具门禁当成完备安全沙箱。
+
+## 提前做体验设计
+
+编码前检查加载/空态/失败/恢复、长任务进度、取消与重试、重复提交、草稿保留、键盘焦点、可访问性、窄屏/高 DPI/浅深主题以及性能预算。选择与需求有关的改进，不擅自扩展产品范围。运行时用实际交互验证这些状态，面向用户的错误信息给出可执行下一步，避免暴露内部实现。
+
+交付附上改动与调用链影响、实际通过项、失败/跳过/阻塞项、证据位置和剩余风险。缺凭据、设备或依赖属于“未验证”；不得用静态契约或替身截图写成“模拟真机通过”。

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

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-develop",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "动手写码前先看开发流程，从领任务到提 PR",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "跨语言协作，编码规范通则和 DoD 怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "不确定用哪条语言链，先看开发子链",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "帮我写个提交信息",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次单元测试补齐",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/eng-docs/SKILL.md

@@ -34,6 +34,30 @@ Markdown 为体,渲染为用;图 as code(mermaid:架构图/时序图/状态机),
 - ADR(eng-architecture)/接口契约(api-design)/集成档案(eng-integration)/部署与配置说明(eng-release)/数据字典(data-governance)——各链产物,本链管"有没有、放哪、活没活着";
 - 新人上手路径:第一天(环境+跑通)/第一周(架构导读+首个小任务)/首月(值班跟班)——**上手时长是文档体系的终极验收指标**(eng-efficiency 采样)。
 
+## 详略层级判定（写之前先定"这篇管到哪一层"）
+
+类型判据决定**写成什么形态**，层级判定决定**写到多深**——两件事，都要先定。规则三句：
+
+- 这篇文档**自己的主题**：写足细节；
+- 它的**直接下级主题**：一句话交代职责与边界，然后给链接；
+- 更深的：一个字都不写，全部交给拥有它的那篇。
+
+判断某段该不该留在这里，问：**有没有另一篇文档更该拥有这段话？**有 → 挪过去留链接。
+不这么切的后果很具体：同一件事在三篇里各写了一遍，改的时候只改得动其中一篇，
+剩下两篇变成**错误文档**——比没有文档更危险（见下一节）。
+
+## 常驻文档的篇幅上限（棘轮：只准降不准升）
+
+**只给"反复被读"的文档设上限**：README、规范类、上手路径。一次性产物（研判报告、季检清单、方案）
+本来就该写多长写多长，给它设上限是把工具用错地方。
+
+- 上限记在一份清单里，超了就是不合格，闸会拦（`npm run gates` 里的 `doc-budgets`）；
+- 文档缩短了就把上限往下收（`--write`），**只降不升**；
+- 要抬高上限，必须手改清单并在提交信息里写清为什么值得——这一下摩擦就是它的全部作用。
+
+这与本链「不度量字数与篇数」不冲突：**上限是防膨胀的闸，不是考核指标**。
+没人会因为字数少拿分，只会因为常驻文档在无声变胖被拦下来。
+
 ## 文档腐化治理（文档最大的问题不是没有,是不可信）
 
 每篇关键文档三件套:Owner/最后验证日期/**保鲜期**(教程与 Runbook 90 天,参考类跟代码生成,解释类一年);

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

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-docs",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "建技术文档体系，README 和 Runbook 怎么写",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "文档腐化，保鲜期和度量怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "新人上手慢，知识回写闭环怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份对外的产品白皮书",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次知识库 SOP 运营",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-efficiency",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "研发效能度量立项，DORA 四键怎么采",
+      "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-infra/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-infra",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "上云建环境，IaC 漂移怎么检测",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "K8s 探针配额 HPA 怎么治理",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "云成本失控，FinOps 和灾备定级怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次数据库高可用方案",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段服务的健康检查接口",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-integration",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "对接支付和 ERP，第三方集成五阶段怎么走",
+      "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/eng-legacy/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-legacy",
+  "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,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份技术债清单",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-observability",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "建监控体系，指标链路日志三支柱怎么分工",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "告警风暴降噪，SLO 和错误预算怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "排障没数据，埋点标准和 TraceID 怎么贯穿",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次智能运维的根因推荐",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段日志采集的配置",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-ops",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "建值班体系，oncall 轮值和升级怎么排",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "线上事件 P1 分级响应和作战通道",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "复盘 Postmortem 闭环，备份恢复演练怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次工单流程的 ITIL 落地",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份容量评估报告",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-performance",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "接口慢，压测方案怎么选",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "容量评估和大促备战，水位怎么规划",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "性能劣化排查，RED USE 怎么定位瓶颈",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次慢 SQL 的索引优化",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段前端首屏分包",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-planning",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "WBS 拆解和故事点估算怎么做",
+      "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/eng-quality/SKILL.md

@@ -68,6 +68,14 @@ engineering-chain 的质量环节子链。质量不是测出来的,是设计+防
 
 **作业包**:`references/test-plan-templates.md`(测试方案一页纸/准入准出单/缺陷报告模板/逃逸分析卡)。
 
+## 机器可查的部分
+
+`run_tests` 跑测试并解析结果（Maven/Gradle/pytest/Node 统一走 JUnit XML 或 node:test 输出）：给出通过/失败数、每个失败用例的**期望值与实际值**、以及堆栈里第一个非测试非框架的位置。
+`code_inspect` 查测试自身的质量：恒真断言、没有断言的用例、`.only` 残留、公共函数无覆盖。
+`test_plan` 在补用例前算清该测几条路、参数边界在哪、项目用什么框架放哪个目录。
+
+机器判不了、仍要人看的：用例是否验证了**业务意图**而不只是当前实现、替身边界划得对不对、测试数据是否覆盖了真实的脏数据形态。
+
 ## 使用纪律
 
 用例与验收标准同源,需求变更用例同步变;每个线上缺陷回写两件事:回归用例+逃逸分析补防线;

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-quality",
+  "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,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次接口自动化脚本",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-release",
+  "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,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次流水线门禁配置",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-reliability",
+  "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,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份 SLO 口径定义",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,12 @@
+{
+  "skill": "eng-requirements",
+  "purpose": "触发行为规格。与 product-design 是刻意分层：PRD 结构与原型细则由 product-design 承接，本技能是需求环节子链深耕。",
+  "intentionalOverlap": ["product-design"],
+  "cases": [
+    { "id": "vague-ask", "prompt": "接到一个很模糊的诉求，怎么澄清歧义拆成故事", "shouldTrigger": true },
+    { "id": "dor", "prompt": "需求评审的准入基线怎么定，DoR 该包含什么", "shouldTrigger": true },
+    { "id": "change-control", "prompt": "需求变更失控了，怎么建追踪矩阵管起来", "shouldTrigger": true },
+    { "id": "near-miss-prd", "prompt": "帮我写一份 PRD 产品需求文档", "shouldTrigger": false },
+    { "id": "near-miss-code", "prompt": "这段代码帮我审查一下", "shouldTrigger": false }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-research",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "要不要引入这个新技术，怎么评估",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "技术选型调研，评分卡权重怎么定",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "POC 时间盒和退出成本怎么算",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次竞品的产品功能拆解",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份市场调研问卷",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,31 @@
+{
+  "skill": "eng-security",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "安全评审，STRIDE 威胁建模怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "依赖漏洞应急，SCA 和 SBOM 怎么管",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "上线安全准入，密钥全生命周期怎么治",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次等保合规的审计执行",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一段登录鉴权的代码",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "skill": "eng-ux",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "界面设计评审，可用性问题怎么整改",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "建设计规范，信息架构和表单怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "开发还原走查，无障碍底线在哪",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一份 PRD 产品需求文档",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次品牌 VI 规范",
+      "shouldTrigger": false
+    }
+  ]
+}

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

@@ -0,0 +1,30 @@
+{
+  "skill": "engineering-chain",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "工程技能链总控，24 条环节子链怎么选",
+      "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/env-offline/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "env-offline",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "交付到隔离内网，依赖怎么离线化",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "现场装不上，离线一键安装和自检怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "内网证书过期和 NTP 时间问题怎么排",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次私有化客户的版本管理",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份国产化适配矩阵",
+      "shouldTrigger": false
+    }
+  ]
+}