@huicai/cli 2026.712.80880 → 2026.721.0

package/skills/eng-quality/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: eng-quality
+description: 质量测试链（测试金字塔与策略→用例设计六法判据→分层实施(单元/集成/契约/E2E)→回归圈定→测试数据管理→缺陷分级与闭环→准入准出门禁→逃逸分析）。工程链质量环节深耕:定测试方案、写用例、建质量门禁、缺陷失控或漏测复盘时载入。单测写法由 write-tests、评审由 code-review 承接。
+version: 1.0.0
+---
+
+# 质量测试链
+
+engineering-chain 的质量环节子链。质量不是测出来的,是设计+防线+反馈闭环共同的产物;
+本链管防线设计与缺陷闭环。用例的唯一来源=验收标准(eng-requirements 同源纪律)。
+
+## 测试策略:金字塔与配比
+
+- 参考配比:单元 70% / 集成 20% / E2E 10%(数量级示意,不是 KPI);
+- **倒金字塔(E2E 一堆、单测没有)=维护灾难信号**:跑得慢、坏得勤、坏了不知道哪坏;
+- 每层回答不同问题:单元=逻辑对不对;集成=拼起来通不通;契约=你我约定破没破;E2E=用户旅程走不走得通;
+- 测试象限补盲:探索性测试(不可脚本化的"感觉不对")与非功能(性能→eng-performance,安全→eng-security)排进计划,不是有空才做。
+
+## 用例设计六法（判据+示例）
+
+| 方法 | 启用信号 | 要点 |
+|---|---|---|
+| 等价类 | 输入有范围/分类 | 有效/无效类各取代表,别全排列 |
+| 边界值 | 有 min/max/长度限制 | 三点法:边界-1、边界、边界+1;off-by-one 高发区 |
+| 判定表 | 多条件组合决定行为 | 条件>3 个必用,防漏组合;先删不可能组合 |
+| 状态迁移 | 有状态机(订单/审批/任务) | 每条合法迁移+**每条非法迁移**(已取消订单还能支付吗) |
+| 正交法 | 参数组合爆炸(兼容矩阵) | 正交表压缩组合数,保证两两覆盖 |
+| 错误推测 | 有历史缺陷库 | 空值/超长/重复提交/并发双击/权限窜号/时区,经验清单化 |
+
+每故事用例必含三类:主路径、边界、异常路径——与验收标准结构一一对应。
+
+## 分层实施要点
+
+- **单元**(write-tests 承接):FIRST 原则(快/独立/可重复/自验证/及时);mock 边界纪律——只 mock 我不拥有的(外部服务/时钟/随机),自己的领域逻辑不 mock(mock 自己=测了个寂寞)。
+- **集成**:真依赖优先(容器化数据库,如 testcontainers 思路),内存库与真库的方言差异会漏 bug;用例间数据隔离(事务回滚或独立数据集)。
+- **契约**:消费者驱动;契约文件与 api-design 的接口文档同源;提供方 CI 跑契约验证,破坏性变更在合入时被拦而不是联调时被骂。
+- **E2E**:只保关键用户旅程 **≤15 条**(多了必脆);选择器用语义属性(data-testid)不用样式类名;失败自动留证据(截图/日志/trace)。
+- **自动化工程孙链**:接口自动化框架与治理(断言四层/造数/失败三分类)载 **qa-api-automation**;UI 自动化稳定性工程(等待纪律/flaky 治理)载 **qa-ui-automation**;移动端(云真机矩阵/弹窗 watcher/兼容云测)载 **qa-mobile-automation**。
+
+## 回归策略
+
+- 变更影响圈定位:调用链(谁调我/我调谁)+数据链(读写哪些表)+配置面,圈内用例必跑;
+- 全量回归判据:发版前、架构/框架升级后、核心模块重构后;
+- 回归用例集分级:P0 冒烟(10 分钟内,每次提测跑)/P1 核心(每日)/P2 全量(发版)。
+
+## 测试数据管理
+
+构造器/工厂模式造数(测试自带数据,不依赖环境现存数据);敏感数据一律脱敏样本(eng-security 分级);
+**用例间不共享可变数据**(共享=偶发失败之源);时间相关用固定时钟注入,不用 sleep 和 now()。
+
+## 缺陷管理
+
+- 严重度定义表:**S1** 主流程不可用/数据损坏/资损(停下所有事)、**S2** 核心功能错但有绕行、**S3** 次要功能/体验、**S4** 建议;严重度看影响,优先级看处理顺序,两者分开标。
+- 缺陷报告三要素:最小复现步骤 / 期望 vs 实际 / 环境与账号——缺一打回;
+- **先复现后修复**:复现不了的缺陷挂起并加观测(eng-observability),不许"盲修一版试试";
+- 修复必附回归用例(这条缺陷从此有人站岗);
+- 缺陷逃逸分析(线上缺陷必做):漏在哪一层(用例没设计到/设计到没执行/执行了没发现)→ 对应补强,归因到环节不归因到人。
+
+## 准入准出门禁
+
+- **提测准入**:冒烟自测通过(录屏或勾单)/部署与配置说明/变更影响范围声明/自测数据可复用——不满足退回,**带病提测浪费的是两个人的时间**;
+- **发布准出**:S1S2 清零、S3 有绕行方案并知会业务、回归 P0P1 全绿、性能基线无劣化(eng-performance)——准出结论写进发布单(eng-release)。
+
+## 质量度量（看趋势不看单点）
+
+缺陷逃逸率(线上缺陷/总缺陷)、回归通过率、用例维护成本(修用例时间/写用例时间)、平均修复时长。
+**反对唯覆盖率**:覆盖率是下限告警(过低说明没写),不是目标(为覆盖率写的断言空转用例更糟)。
+
+**作业包**:`references/test-plan-templates.md`(测试方案一页纸/准入准出单/缺陷报告模板/逃逸分析卡)。
+
+## 使用纪律
+
+用例与验收标准同源,需求变更用例同步变;每个线上缺陷回写两件事:回归用例+逃逸分析补防线;
+质量门禁只加不减(要减必须走评审并留 ADR)。**测试的产出不是"发现了多少 bug",是"守住了哪些不再犯"。**

package/skills/eng-quality/references/test-plan-templates.md

@@ -0,0 +1,46 @@
+# 测试作业模板包（eng-quality 落笔件）
+
+## 1. 测试方案一页纸
+
+| 项 | 内容 |
+|---|---|
+| 范围与不测 | 测 __;明确不测 __(理由) |
+| 分层策略 | 单元 __%/集成 __/契约 __/E2E __ 条(≤15) |
+| 用例来源 | 验收标准(同源纪律,REQ-__);六法适用: □等价类 □边界 □判定表 □状态迁移 □正交 □错误推测 |
+| 数据与环境 | 造数方式 __;环境 __;敏感数据已脱敏 |
+| 非功能 | 性能→eng-performance(基线 __);安全用例→eng-security;兼容矩阵 __ |
+| 准入/准出 | 见下两单 |
+| 风险 | 排期/环境/依赖 TOP3:__ |
+
+## 2. 提测准入单
+
+- [ ] 冒烟自测通过(录屏或勾单)  - [ ] 部署与配置说明
+- [ ] 变更影响范围声明(调用链+数据链圈定)  - [ ] 自测数据可复用
+> 不满足退回——带病提测浪费两个人的时间。
+
+## 3. 发布准出单
+
+- [ ] S1/S2 清零;S3 有绕行方案并知会业务
+- [ ] 回归 P0/P1 全绿;flaky 重试通过的已标记复查
+- [ ] 性能基线无劣化(perf-baseline compare 退出码 0)
+- [ ] 遗留缺陷清单已同步(编号/绕行/计划)
+
+## 4. 缺陷报告模板(三要素缺一打回)
+
+```
+标题: <模块>-<一句话现象>
+严重度: S1|S2|S3|S4   优先级: P_(分开标)
+环境: <版本/环境/账号>
+复现步骤: 1.. 2.. 3..(最小步骤)
+期望: __
+实际: __(截图/日志/traceId)
+```
+
+## 5. 缺陷逃逸分析卡(线上缺陷必填)
+
+| 问 | 答 |
+|---|---|
+| 漏在哪层 | □用例没设计到 □设计到没执行 □执行了没发现 |
+| 六法哪法本可覆盖 | __(补用例 TC-__) |
+| 防线补位 | 回归用例已加:__;规则/门禁已加:__ |
+> 归因到环节不归因到人;每个线上缺陷回写两件事(用例+防线)。

package/skills/eng-release/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: eng-release
+description: 发布链（分支与版本策略判据→CI 流水线三级门禁→发布模式判据表(滚动/蓝绿/金丝雀/灰度)→DB 变更协同 expand-contract→发布清单→回滚预案量化→特性开关治理→紧急通道）。工程链发布环节深耕:定发布流程、上线方案评审、发布事故后加固、开关泛滥治理时载入。逐项清单由 release-checklist、提交规范由 commit-and-pr 承接。
+version: 1.0.0
+---
+
+# 发布链
+
+engineering-chain 的发布环节子链。发布的目标不是"发出去",是**可预期地发出去+可秒回地退回来**。
+
+## 分支与版本策略判据
+
+| 策略 | 启用信号 | 代价 |
+|---|---|---|
+| Trunk-Based | CI 强、开关成熟、日发布 | 要求纪律高:小步提交+开关隔离未完特性 |
+| GitHub Flow | 单版本在线服务(默认推荐) | 分支寿命须短(<3 天),长寿分支=合并地狱 |
+| GitFlow | 多版本并行维护(交付型/客户端) | 流程重;在线服务用它=自找麻烦 |
+
+版本号:对外契约用 SemVer(破坏性变更=major,别用 minor 偷渡);内部服务日期版本(2026.07.1)亦可;
+CHANGELOG 面向使用者写"影响"(升级要做什么),不是 git log 复制。
+
+## CI 流水线三级门禁
+
+- **L1 提交级(<10min)**:编译+单测+lint+敏感信息扫描——超 10 分钟没人等,治理见 dev-toolchain 构建缓存;
+- **L2 合入级**:集成测试+契约验证(eng-quality)+SCA 依赖扫描(eng-security);
+- **L3 发布级**:E2E 关键旅程+性能基线对照(eng-performance)+镜像扫描与制品签名。
+红灯纪律:主干红灯 15 分钟内认领,红灯期间**只允许修复性合入**;"先合了再说"=对全团队加税。
+制品纪律:一次构建多处部署(测试与生产同一制品,只换配置),**禁止各环境各自构建**。
+流水线工程实现(模板库/缓存工程/密钥安全/制品管理/flaky 治理)载 **cicd-pipeline**;
+私有化/多客户交付(版本碎片治理/环境预检/升级编排)载 **env-private-deploy**。
+
+## 发布模式判据表
+
+| 模式 | 适用 | 回滚速度 | 代价 |
+|---|---|---|---|
+| 滚动 | 默认;无状态服务 | 分钟级(反向滚动) | 新旧版本短暂共存,兼容要求见下 |
+| 蓝绿 | 回切要求秒级;有钱 | 秒级切流 | 双倍资源;DB 变更难以蓝绿 |
+| 金丝雀 | 高风险变更 | 秒级摘除 | 1%→5%→25%→100%,**每级观察指标与时长预先固化**,不许"看着没事就放" |
+| 按人群灰度 | 业务特征分流(新功能试点) | 开关级 | 需要分流基建;实验设计衔接 ab-testing |
+
+新旧共存兼容纪律:滚动/金丝雀期间新旧版本同时服务,**接口与消息格式必须兼容上一版**(api-design 只加不改不删)。
+
+## DB 变更协同（发布事故重灾区）
+
+expand-contract 五步:加新结构(兼容旧代码)→双写→回填校验→切读→下线旧结构(下一个版本才删);
+**代码可回滚的前提是 schema 兼容上一版代码**——"发布+删列"同版本=回滚死路;
+大表 DDL 与数据回填限流错峰;细则见 **eng-database** 变更迁移节。
+
+## 发布前清单（release-checklist 承接逐项执行）
+
+变更清单与影响面声明 / 准出结论(eng-quality:S1S2 清零) / **回滚方案且演练过**(没演练过的回滚方案=祈祷文) /
+监控与告警就位(新功能的指标提前上,eng-observability 三件套准入) / 依赖方与客服知会 /
+发布窗口与值守表(避开周五下午与大促前) / 数据变更有备份快照。
+
+## 回滚纪律
+
+- **回滚条件预先量化写死**:如"错误率>1% 持续 5 分钟,或 P99>基线 2 倍持续 10 分钟,立即回滚"——现场不辩论、不等"再看看";
+- **先回滚后排查**(恢复优先,eng-ops 同则);回滚也是变更,同样走观察期;
+- 不可回滚变更(数据迁移/外发通知/资金操作)单独评审,必须有前向修复预案与暂停点;
+- 每次真实回滚后复盘:回滚耗时实测值回填(声称 5 分钟实际 40 分钟=预案造假)。
+
+## 特性开关治理（开关是债,不是免费午餐)
+
+- 三类分治:发布开关(隔离未完特性,**合入后 ≤2 周清理**)、运营开关(降级/限流,长期,纳入演练)、权限开关(套餐/灰度人群,长期,有 Owner);
+- 开关登记表:名称/类型/Owner/到期日/默认值;**僵尸开关季度清扫**(开关组合爆炸=测不过来的状态空间);
+- 开关默认值=安全侧(开关系统失联时业务应落到哪边,想清楚再上线)。
+
+## 紧急发布通道
+
+精简但不为零:双人复核 + 冒烟用例 + 回滚预案三件必留;跳过的环节记欠账,24h 内补(补测试/补文档);
+紧急通道使用频率月度复盘——**次次走紧急=流程设计有病,不是业务太急**。
+
+**作业包**:`references/release-plan-template.md`(发布单:模式与观察项/回滚条件量化写死/不可回滚项声明——观察期结束才关单)。
+
+## 使用纪律
+
+上线≠结束:观察期(按变更风险 30min–24h)盯板完成才关发布单(衔接 itsm-ops 变更单与 eng-observability 发布事件线);
+每次发布事故回写:清单加项或门禁加固;发布频率与失败率、恢复时长一起看(只求稳不发布=另一种失败)。

package/skills/eng-release/references/release-plan-template.md

@@ -0,0 +1,36 @@
+# 发布单模板（eng-release 落笔件:一次发布一单,观察期结束才关单）
+
+## 基本信息
+
+| 项 | 内容 |
+|---|---|
+| 发布单号/版本 | REL-__ / v__ |
+| 内容与影响面 | 特性:__(REQ-__);影响模块:__;用户可感知变化:__ |
+| 制品 | 镜像/包 digest:__(一次构建多处部署——与测试同制品) |
+| 窗口与值守 | __月__日 __:__;值守:__;避开:□周五下午 □大促/月结前 |
+| 发布模式 | □滚动 □蓝绿 □金丝雀(1%→5%→25%→100%,每级观察 __ 分钟) □按人群 |
+
+## 前置检查(release-checklist 逐项,此处摘要)
+
+- [ ] 准出结论(test-plan 准出单)  - [ ] DB 变更 expand-contract:schema 兼容上一版代码
+- [ ] 新功能监控与告警提前上(可观测三件套)  - [ ] 依赖方/客服已知会
+- [ ] 特性开关:__(类型/默认值/清理日期)  - [ ] 韧性评审过(重大特性,resilience-review)
+
+## 回滚预案(量化写死,现场不辩论)
+
+| 项 | 内容 |
+|---|---|
+| 回滚触发条件 | 错误率>__% 持续 __ 分钟,或 P99>基线 __ 倍持续 __ 分钟,或 __ |
+| 回滚方式与耗时 | __(演练实测 __ 分钟——没演练过的预案=祈祷文) |
+| 不可回滚项 | □无 □有:__(前向修复预案:__;暂停点:__) |
+| 数据备份 | 快照:__ |
+
+## 观察期(30min–24h 按风险)
+
+- 观察项: 错误率 __ / P99 __ / 业务指标 __ / 新功能指标 __ / (AI 特性)质量指标 __
+- 观察结论: __;发布事件已打点(eng-observability 事件线)
+- [ ] 观察期结束,关单(itsm-ops 变更单同步)
+
+## 复盘回写(如有异常)
+
+紧急通道使用? □否 □是(欠账 24h 内补:__);清单需加项:__

package/skills/eng-reliability/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: eng-reliability
+description: 可靠性工程链 SRE（容错设计模式判据表(超时/重试/熔断/舱壁/降级/限流/背压)→强弱依赖治理与年检→混沌工程前提与成熟度阶梯→演练体系记分→上线韧性评审 what-if 清单→错误预算驱动）。工程链可靠性深耕:系统老出连锁故障、容错方案评审、混沌演练立项、大促稳定性保障时载入。事件响应流程走 eng-ops,SLO 口径走 eng-observability。
+version: 1.0.0
+---
+
+# 可靠性工程链
+
+engineering-chain 的可靠性子链。分工:eng-ops 管**事后**(事件响应与复盘),本链管**事前**(把故障挡在设计里、把恐慌消灭在演练里);
+可靠性目标从 SLO 来(eng-observability),多余的钱花在这条链上最值。
+
+## 容错设计模式判据表（评审用,每个外部调用过一遍）
+
+| 模式 | 何时必配 | 参数要点 | 常见翻车 |
+|---|---|---|---|
+| 超时 | **每个外部调用,无例外** | 层层收紧(入口>内部>叶子);按下游 P99×1.5 定,不拍脑袋 | 不设=线程占满连锁死;全链同值=同时炸 |
+| 重试 | 幂等操作+瞬时故障 | 指数退避+抖动;**重试预算**(总量≤10% 流量);只重试可恢复错误(超时/503,不重 4xx) | 非幂等重试=重复扣款;层层重试=流量放大爆炸(3 层各 3 次=27 倍) |
+| 熔断 | 依赖会大面积慢/挂 | 错误率阈值+最小请求数;半开探测恢复 | 阈值太灵敏=抖断;熔断后无降级=换个姿势挂 |
+| 舱壁 | 多依赖共享资源 | 按依赖隔离线程池/连接池 | 一个慢依赖吃光公共池=全员陪葬 |
+| 降级 | 非核心功能/柔性体验 | 预案分级(关推荐/展示缓存/只读模式);**开关可一键触发**(eng-release 运营开关) | 降级路径没测过,一开更炸 |
+| 限流 | 入口与稀缺资源 | 令牌桶(容突发)vs 漏桶(恒速)判据;按调用方配额 | 限流值没压测依据;被限方无友好提示 |
+| 背压 | 生产快于消费 | 有界队列+拒绝策略;消费端拉模式 | 无界队列=延迟 OOM 双雪崩 |
+
+组合纪律:超时是地基,重试踩着超时,熔断护着重试——**只配重试不配超时与预算=自制 DDoS**。
+
+## 强弱依赖治理
+
+- 标注:每个依赖标强(挂了核心不可用)/弱(挂了降级可用);**标注要用故障注入验证**(嘴上说弱,一断全崩的比比皆是);
+- 目标:强依赖只留必需(认证/核心数据),其余全部弱化(缓存兜底/默认值/异步补偿);
+- 弱依赖三件套:超时短、熔断快、降级路径已演练;
+- **依赖年检**:新增依赖要评审(引入即负债),存量依赖每年验一次强弱标注与预案有效性;
+- 环依赖与隐藏依赖(共享 DB/共享缓存/同一个配置中心)排查进架构健康检查(eng-architecture)。
+
+## 混沌工程（科学实验,不是搞破坏）
+
+- **三前提缺一不做**:稳态假设可量化(SLI 正常带,eng-observability)/爆炸半径可控(先单实例、影子流量、非峰时段)/一键停止(实验开关+自动中止条件:SLI 破线即停);
+- 成熟度阶梯:测试环境手动注入 → 预发常态化 → 生产只读路径小半径 → 生产例行(游戏日)——**跳级=事故预定**;
+- 实验设计模板:假设(杀掉一个 Pod,可用性不受影响)/注入方式(实例宕机/网络延迟丢包/依赖超时/资源耗尽/时钟漂移)/观察指标/中止条件/结论回写;
+- 实验优先级:从复盘中来(上次事故暴露的薄弱面先验)、从强弱依赖标注来(验"弱"是不是真弱);
+- 产出纪律:每次实验要么证实(信心+1)要么证伪(修复项入台账)——没有结论的实验=白折腾。
+
+## 演练体系（肌肉记忆工程）
+
+| 演练 | 频率 | 记分点 |
+|---|---|---|
+| 预案演练 | 季度 | 每个降级/切流预案真开一次,失效预案当场修(没演练过的预案=祈祷文,eng-release 同则) |
+| 故障演练(游戏日) | 半年 | 注入未预告的故障,记 发现时长/定位时长/恢复时长,对照 SLA |
+| 多活/灾备切流 | 季度~半年 | 真切流量(哪怕 5%),RTO/RPO 实测回填(eng-infra 灾备等级) |
+| 值班新人带练 | 每轮换 | 模拟 P2 走全流程(eng-ops oncall 上岗前置) |
+
+记分公开但不排名(eng-efficiency 度量纪律);演练暴露的问题与真事故同权重进 action 闭环。
+
+## 上线韧性评审（what-if 清单,重大特性发布前）
+
+逐条问并要答案(答不出=预案缺口):最大依赖挂 10 分钟,用户看到什么?/流量突增 5 倍,先垮哪层,限流保谁弃谁?/
+数据库主库切换的 30 秒,写请求怎么办?/缓存全失效(重启/雪崩),DB 扛得住穿透吗?/
+这个新特性能被一键关掉吗?/回滚要多久,谁有权限执行?——
+答案写进发布单(eng-release),高风险缺口阻断上线或带条件放行(条件挂 Owner)。
+
+## 错误预算驱动（可靠性的经济学）
+
+预算充裕→敢发布敢实验(混沌实验也花预算,花得值);预算紧张→收紧变更、优先还稳定性债;
+预算耗尽→冻结特性只发修复(eng-observability 联动机制的执行面);
+**可靠性不追求 100%**:每提升一个 9,成本量级上涨——目标从业务后果倒推(eng-architecture 非功能量化),超出 SLO 的可靠性投入是浪费。
+
+**作业包**:`references/resilience-review.md`(what-if 六问评审单/外部调用容错配置表/强弱依赖年检表/混沌实验卡/演练记分表)。
+
+## 使用纪律
+
+新外部调用过容错判据表(评审必查);预案没演练不算数;混沌实验必有结论回写;
+每次连锁故障复盘补的不只是那个点,是那**类**模式(判据表增补)——
+**可靠性的复利=被验证过的预案数量×团队肌肉记忆**。

package/skills/eng-reliability/references/resilience-review.md

@@ -0,0 +1,43 @@
+# 韧性评审与演练记录（eng-reliability 落笔件）
+
+## 1. 上线韧性评审 what-if 单(重大特性发布前,答不出=预案缺口)
+
+| 问题 | 答案(写具体,"没问题"不是答案) |
+|---|---|
+| 最大依赖 __ 挂 10 分钟,用户看到什么? | |
+| 流量突增 5 倍,先垮哪层?限流保谁弃谁? | |
+| DB 主库切换的 30 秒,写请求怎么办? | |
+| 缓存全失效(重启/雪崩),DB 扛得住穿透吗? | 回源限流值:__ |
+| 这个特性能被一键关掉吗? | 开关:__ |
+| 回滚要多久?谁有权限执行? | 实测 __ 分钟 / __ |
+
+结论: □通过 □带条件放行(缺口+Owner+期限:__) □阻断
+
+## 2. 外部调用容错配置表(每个新外部调用登记一行)
+
+| 调用 | 超时(按下游P99×1.5) | 重试(幂等?退避?预算) | 熔断 | 降级路径 | 舱壁隔离 |
+|---|---|---|---|---|---|
+| 例:调支付网关 | 2s | 是/指数/≤10% | 错误率50%断 | 排队页 | 独立线程池 |
+
+> 只配重试不配超时与预算=自制 DDoS;层层重试=流量放大(3 层×3 次=27 倍)。
+
+## 3. 强弱依赖标注表(年检,嘴上说弱要注入验证)
+
+| 依赖 | 标注(强/弱) | 验证方式(故障注入日期) | 弱依赖三件套(短超时/快熔断/已演练降级) |
+|---|---|---|---|
+
+## 4. 混沌实验记录卡(三前提缺一不做)
+
+- 稳态假设(可量化):__(SLI 正常带)
+- 爆炸半径:□测试环境 □预发 □生产单实例/影子流量;非峰时段 __
+- 一键停止:实验开关 __;自动中止条件:SLI 破线 __
+- 注入方式:□实例宕机 □网络延迟/丢包 □依赖超时 □资源耗尽 □时钟漂移
+- 结果: □证实(信心+1) □证伪→修复项 __ 入台账(没有结论=白折腾)
+
+## 5. 演练记分表(季度)
+
+| 演练 | 日期 | 发现时长 | 定位时长 | 恢复时长 | 失效预案(当场修) | 下次 |
+|---|---|---|---|---|---|---|
+| 预案/游戏日/切流/新人带练 | | | | | | |
+
+> 记分公开不排名;演练暴露的问题与真事故同权重闭环。

package/skills/eng-requirements/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: eng-requirements
+description: 需求分析子链（需求采集分级→澄清与歧义消除→Epic/Story 拆解→Gherkin 验收标准→DoR 准入→评审基线→变更管理→RTM 追踪矩阵）。工程链需求环节深耕:接到模糊诉求、写 PRD/用户故事、需求评审、需求变更失控时载入。PRD 结构与原型细则由 product-design 承接。
+version: 1.0.0
+---
+
+# 需求分析子链
+
+engineering-chain 的需求环节子链。上游是业务诉求/用户反馈/线上问题,下游交付给
+**eng-architecture**（架构约束输入）与 **eng-planning**（排期输入）。
+产物清单:需求列表(分级)、用户故事+验收标准、需求基线、RTM 追踪矩阵。
+
+## 需求采集与分级
+
+| 来源 | 特点 | 处理纪律 |
+|---|---|---|
+| 战略/管理层 | 目标态,粒度粗 | 先拆解为可验证的业务指标再进流程 |
+| 业务/运营 | 常以"解决方案"形式出现 | 剥离方案还原问题（见反模式表） |
+| 用户反馈/客服 | 碎片化,幸存者偏差 | 聚类+频次统计,单条不立项 |
+| 线上问题 | 紧急,易插队 | 走 itsm-ops 事件流,修复型需求单列 |
+| 技术驱动 | 还债/升级/合规 | 必须翻译成业务语言（风险/成本数字） |
+
+优先级双轴定级:**价值用 Kano**（基本型不做=投诉;期望型线性;兴奋型差异化）,
+**排序用 MoSCoW**（Must/Should/Could/Won't——Won't 要明说并记录,防止反复重提）。
+
+## 澄清工作流
+
+1. **5W2H 过一遍**:Who(给谁用/多少人)、What(做什么)、Why(不做的代价)、When(时间约束及其来源)、Where(什么场景终端)、How(现在怎么干的)、How much(量级:数据量/并发/频次)。
+2. **歧义词黑名单**——出现必量化:"支持大量"→给数字;"快"→给 P99 毫秒;"稳定"→给可用性目标;"优化"→给基线与目标值;"尽快"→给日期与依据;"兼容"→给版本矩阵。
+3. **边界三问**:不做什么(明确排除项)、异常怎么办(失败/超时/权限不足)、存量数据怎么办(迁移/兼容/双轨)。
+4. 访谈提纲:先问现状流程(让对方走一遍现在的操作),再问痛点频次与代价,最后才谈方案——**先听问题,后谈方案**。
+
+## 拆解:Epic → Story → Task
+
+- 层级纪律:Epic(业务目标,周~月级) → Story(用户可感知的价值切片,≤3 人天) → Task(技术活动,进 eng-planning WBS)。
+- 故事模板:作为〈角色〉,我要〈能力〉,以便〈价值〉——"以便"写不出来的故事先回澄清环节。
+- **INVEST 检查**:独立(可单独上线)/可协商/有价值(用户可感知)/可估算/足够小/可测试。不满足"小"的拆分技法:按流程步骤切、按数据类型切、按 CRUD 切、按角色切、先走通主干再增强(happy path 先行)。
+- 技术任务(重构/升级)也进列表但标记为使能故事,挂在受益的业务故事之下。
+
+## 验收标准（本子链核心产出）
+
+- 格式:Gherkin 三段式 `Given 前置 / When 动作 / Then 可观察结果`,每故事 3–7 条;超过 7 条=故事太大,回拆解。
+- **可判定性检验**:一个没参与讨论的人,只看标准+操作系统,能独立判 PASS/FAIL,不需要问任何人。判不了=写得不合格。
+- 必含三类:主路径、边界(空/超长/并发/重复提交)、异常路径(失败提示与恢复)。
+- 非功能验收进故事:性能(P99 目标)、兼容矩阵、权限矩阵、数据口径——**非功能不写进验收标准=默认不验收=上线后扯皮**。
+- 同源纪律:验收标准是唯一事实源,测试用例(eng-quality)与上线验收单(eng-release)都从它派生,不许三处三个说法。
+
+## DoR 准入清单（进迭代前逐项勾）
+
+验收标准可判定 / 依赖已识别(外部接口、其他团队、数据就绪) / UI 稿或交互说明到位(涉界面,eng-ux) /
+埋点需求已附(eng-observability) / 数据口径已核(涉指标,data-governance) / 估算完成(eng-planning) /
+提出人可在迭代内答疑。**不满足 DoR 的故事不进迭代,进了也做不完。**
+
+## 需求评审与基线
+
+- 评审会时间盒 ≤1 小时,超时说明批量太大;角色到齐:提出人、开发、测试、UX(涉界面)。
+- 评审逐条过验收标准而不是念 PRD;测试视角提"怎么才算错"往往最能暴露漏洞。
+- 评审通过即打**基线**(版本号+日期):之后一切改动走变更流程,不许"顺口就改了"。
+
+## 变更管理
+
+变更三问(问完再决定):影响范围(哪些已完成工作作废)、工期影响(eng-planning 重估)、不改的代价(能否下迭代)。
+紧急通道存在但留痕:口头需求 24h 内补票,否则不认。变更率>30% 的迭代要复盘采集质量而不是加班消化。
+
+## RTM 需求追踪矩阵
+
+一张表五向勾稽:需求 ID ↔ 设计文档/ADR ↔ 代码 PR ↔ 测试用例 ↔ 上线验证结果。
+上线前扫一遍:有需求无用例=漏测;有代码无需求=镀金或私活,评审必问。
+
+## 反模式速查
+
+| 反模式 | 症状 | 处置 |
+|---|---|---|
+| 方案伪装成需求 | "加个缓存""建个中间表" | 追问背后问题:慢在哪?多慢?谁疼? |
+| 需求镀金 | 无人要的"顺手做了" | RTM 反查,砍掉或补立项 |
+| 干系人缺席 | 上线后冒出"当初没问我" | 采集期画干系人地图,签收基线 |
+| 伪需求 | 提出人自己也说不清 Why | 回到 5W2H,给不出 Why 的进 Won't |
+| 无限澄清 | 追求完美需求不开工 | 时间盒:核心路径清楚即可开工,边界迭代补 |
+
+**作业包**:`references/story-templates.md`(用户故事卡/Gherkin 骨架/DoR 清单/变更单/RTM 表头,复制即用)。
+
+## 使用纪律
+
+验收标准三处同源(用例/上线验收单从它派生);一切变更过基线;
+复盘回写——需求偏差(理解错/漏边界/变更多)按模式归档,下次采集先查偏差模式库。
+**需求环节省下的每一小时,开发测试要还十小时。**

package/skills/eng-requirements/references/story-templates.md

@@ -0,0 +1,47 @@
+# 需求作业模板包（eng-requirements 落笔件:复制即用）
+
+## 1. 用户故事卡
+
+- 故事:作为〈角色〉,我要〈能力〉,以便〈价值——写不出=回澄清〉
+- 量级:数据量 __ / 并发 __ / 频次 __(歧义词黑名单已过:大量/快/稳定均已数字化)
+- 边界:不做 __;异常时 __;存量数据 __
+- INVEST 自查: □独立可上线 □有用户可感知价值 □≤3人天 □可测试
+
+## 2. 验收标准(Gherkin,3–7 条/故事)
+
+```gherkin
+场景: <主路径>
+  Given <前置状态>
+  When  <用户动作>
+  Then  <可观察结果——第三人不用问人能判 PASS/FAIL>
+
+场景: <边界——空/超长/重复提交/并发>
+场景: <异常路径——失败提示与恢复>
+场景: <非功能——P99<__ms @__QPS / 兼容矩阵 / 权限矩阵>
+```
+
+## 3. DoR 准入清单(进迭代前逐项勾)
+
+- [ ] 验收标准可判定(含边界与异常)
+- [ ] 依赖已识别:外部接口 __ / 他团队 __(依赖请求单编号 __,eng-collaboration)
+- [ ] UI 稿/交互说明到位(涉界面)  - [ ] 埋点需求已附(eng-observability)
+- [ ] 数据口径已核(涉指标,data-governance)  - [ ] 估算完成(schedule-calc P80=__)
+- [ ] 提出人迭代内可答疑
+
+## 4. 需求变更单
+
+| 项 | 内容 |
+|---|---|
+| 变更内容 | 原:__ → 新:__ |
+| 三问:影响范围 | 作废工作 __;联动模块 __ |
+| 三问:工期影响 | 重估 +__ 天(eng-planning 重排触发否:偏差>15%?) |
+| 三问:不改的代价 | __(能否下迭代?) |
+| 基线版本 | v__ → v__;评审人 __ 日期 __ |
+
+## 5. RTM 追踪矩阵表头(五向勾稽)
+
+| 需求ID | 验收标准# | 设计/ADR | 代码PR | 测试用例 | 上线验证 |
+|---|---|---|---|---|---|
+| REQ-__ | AC-1..n | ADR-__ | #__ | TC-__ | ✅/❌ 日期 |
+
+> 上线前扫一遍:有需求无用例=漏测;有代码无需求=镀金,评审必问。

package/skills/eng-research/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: eng-research
+description: 调研链（调研问题一句话定义→信息源分级→候选粗筛三关→评分卡权重先行→POC 时间盒→退出成本评估→结论报告结构→技术雷达与复访机制）。工程链调研环节深耕:技术选型、新技术评估、"要不要引入 X"、竞品技术分析时载入。评分卡模板与检索技巧由 tech-research、联网检索由 web-search 承接。
+version: 1.0.0
+---
+
+# 调研链
+
+engineering-chain 的调研环节子链。**没有决策场景的调研是阅读,不是调研**——先问这次调研在支持谁、在哪天、做什么决定。
+
+## 第一步:问题定义（一句话格式）
+
+"为了解决〈问题〉,在〈约束:预算/团队栈/合规/时限〉下,寻找〈能力〉,由〈决策人〉在〈截止日〉前决定。"
+写不出这句话就退回去向提出人澄清;截止日决定调研深度(3 天=桌面研究,2 周=含 POC)。
+
+## 信息源分级（引用必标级）
+
+| 级 | 来源 | 用法 |
+|---|---|---|
+| 一手 | 官方文档/源码/自己跑出来的数据 | 结论只能建在这一级上 |
+| 二手 | 核心维护者演讲、严肃工程博客、issue 讨论 | 提供线索与坑位,关键点回一手验证 |
+| 三手 | 营销稿/排行榜/自媒体/未溯源转述 | 只用于发现候选,**禁止进结论** |
+
+AI 生成内容按三手对待,溯源核实后才可升级;性能对比数字尤其要看测试条件(别人的基准≠你的场景)。
+
+## 候选收敛:粗筛三关 → ≤3 个进深评
+
+1. **活跃度**:近半年提交频率、issue 响应时长、维护者数量(单人项目=巴士系数 1,进风险表);
+2. **许可证合规**:GPL 系对闭源产品的传染性、双许可证的商用条款、专利条款——拿不准过 legal-chain;
+3. **生态与雇佣市场**:招得到人吗、周边库全吗、出了问题搜得到答案吗。
+过关候选 ≤3 个进评分卡;>3 个说明问题定义太宽,回第一步。
+
+## 评分卡（tech-research 承接模板）
+
+- **权重先于候选定**(先看了候选再定权重=给心仪者量身定做);
+- 维度参考:功能匹配/性能实测/运维成本(部署、升级、监控接入)/学习曲线/社区生态/许可证/退出成本;
+- 一票否决项单列不进加权(合规不过/关键功能缺失,总分再高也出局);
+- 评分人 ≥2 且独立打分再对齐,分歧>2 分的维度当面对证据。
+
+## POC 时间盒
+
+- **1–2 周硬上限**,到期必须出结论(可以是"证据不足,按默认选项走"——这也是结论);
+- 场景=生产真实切片:真数据结构(脱敏)、等比缩放的数据量、真部署形态,**demo 跑通≠POC 通过**;
+- 验证点预先写死(评分卡里存疑的 3–5 项),防止 POC 跑成"玩了两周新玩具";
+- 产出=可复跑的代码+数据表+结论,入库存档(别人能复现你的结论才算数)。
+
+## 退出成本评估（进场前先看出口）
+
+数据能否完整导出(格式/工具/速率)?协议是否专有?替换半径多大(多少代码/多少团队要动)?
+供应商锁定项清单(专有 API/专有存储格式/绑定生态)。**退出成本高的选择,评分卡权重里"确定性"要加倍**——上错船比不上船贵得多。
+
+## 结论报告结构（决策人 5 分钟能读完）
+
+1. 结论先行:推荐项+置信度(高/中/低)+一句话理由;
+2. 对比表(评分卡摘要,含一票否决触发情况);
+3. 风险与缓解(TOP3,含巴士系数/锁定项);
+4. 回退条件:什么信号出现说明选错,退到哪、代价多大;
+5. 复访时间:落选项与"暂缓"项何时重看。
+决策拍板后落 **ADR**(eng-architecture),"当时为什么没选 Y"写清楚——防半年后考古重问。
+
+## 技术雷达与复访机制
+
+- 组织级雷达四环:**采用**(默认选择)/**试用**(限定项目用)/**评估**(POC 中)/**暂缓**(明确不碰+原因);
+- 晋级规则:评估→试用要过 POC;试用→采用要两个生产案例+运维承接确认;
+- 季度评审雷达:暂缓项到复访期重看(技术会进步,当年的"不行"会过期);
+- 新技术引入必挂雷达位置,**绕过雷达私自上生产=架构违规**(eng-architecture 收敛纪律)。
+
+**作业包**:`references/research-templates.md`(立项一句话/评分卡(权重先于候选)/POC 记录/结论报告骨架/雷达登记行)。
+
+## 使用纪律
+
+引用必标信息源等级;数字必附测试条件;调研产出入知识库(knowledge-sop)供复用;
+选型决策必落 ADR;**调研的复利=雷达与报告库,让下一次调研从 60 分起步而不是 0 分**。

package/skills/eng-research/references/research-templates.md

@@ -0,0 +1,42 @@
+# 调研作业模板包（eng-research 落笔件）
+
+## 1. 调研立项一句话(写不出=还不该调研)
+
+为了解决〈__〉,在〈约束:预算/团队栈/合规/时限〉下,寻找〈__〉,由〈决策人__〉在〈__日期〉前决定。
+
+## 2. 评分卡(权重先于候选定!)
+
+| 维度 | 权重(先定) | 候选A | 候选B | 候选C | 证据(标信息源等级) |
+|---|---|---|---|---|---|
+| 功能匹配 | __% | | | | 一手:自测/官方文档 |
+| 性能实测 | __% | | | | 一手:POC 数据(附条件) |
+| 运维成本 | __% | | | | 部署/升级/监控接入 |
+| 学习曲线 | __% | | | | |
+| 社区生态 | __% | | | | 活跃度:近半年提交/issue 响应 |
+| 许可证 | __% | | | | 传染性/商用条款(拿不准过法务) |
+| 退出成本 | __% | | | | 数据可导出?替换半径? |
+| **一票否决项** | — | □ | □ | □ | 合规不过/关键功能缺(不进加权) |
+
+评分人≥2 独立打分再对齐;分歧>2 分的维度当面对证据。
+
+## 3. POC 记录(1–2 周硬时间盒)
+
+- 验证点(预先写死 3–5 项):__
+- 场景:生产真实切片(数据规模等比;demo 跑通≠POC 通过)
+- 产出:可复跑代码 __ + 数据表 __(别人能复现才算数)
+- 到期结论:□支持推荐 □证据不足按默认走(这也是结论)
+
+## 4. 结论报告骨架(决策人 5 分钟读完)
+
+1. 结论先行:推荐 __,置信度 高/中/低,一句话理由
+2. 对比表(评分卡摘要+一票否决触发情况)
+3. 风险与缓解 TOP3(含巴士系数/锁定项)
+4. 回退条件:出现 __ 信号说明选错,退到 __,代价 __
+5. 复访时间:落选与"暂缓"项 __ 时重看
+
+## 5. 技术雷达登记行
+
+| 技术 | 环(采用/试用/评估/暂缓) | 进环理由与证据 | Owner | 复访日期 |
+|---|---|---|---|---|
+
+> 晋级规则:评估→试用要过 POC;试用→采用要两个生产案例+运维承接确认;决策落 ADR。