@huicai/cli 2026.712.80880 → 2026.721.0

package/skills/eng-architecture/scripts/capacity-calc.py

@@ -0,0 +1,100 @@
+#!/usr/bin/env python3
+# 容量估算计算器（eng-architecture"先算再设计"公式的可执行版）。python3 stdlib,零依赖。
+# 用法:
+#   python3 capacity-calc.py qps --dau 100000 --actions 20 [--peak 5]
+#   python3 capacity-calc.py storage --rows-per-day 500000 --row-bytes 512 [--days 730] [--replicas 3] [--index-factor 1.5]
+#   python3 capacity-calc.py conn --instances 20 --pool 30 [--db-max 1000]
+#   python3 capacity-calc.py bandwidth --qps 2000 --payload-kb 8
+#   python3 capacity-calc.py pool --cores 8 [--wait-ratio 4]      # 线程池参考(dev-java IO 密集公式)
+#   python3 capacity-calc.py transfer --size-mb 100 --kbps 100    # 传输时长(eng-complex-env 载荷缩放)
+#   python3 capacity-calc.py --selftest
+# 输出含公式过程——数字要能被评审挑战,黑盒结论没有价值。估算精度目标:一个数量级。
+import argparse
+import sys
+
+
+def fmt_bytes(b):
+    for unit in ("B", "KB", "MB", "GB", "TB", "PB"):
+        if b < 1024 or unit == "PB":
+            return f"{b:.1f}{unit}"
+        b /= 1024
+
+
+def cmd_qps(a):
+    avg = a.dau * a.actions / 86400
+    peak = avg * a.peak
+    cap = peak / 0.7
+    print(f"日活 {a.dau:,} × 人均 {a.actions} 次 ÷ 86400 = 平均 {avg:,.0f} QPS")
+    print(f"× 峰值系数 {a.peak}(常态 3–5,秒杀类 10+) = 峰值 {peak:,.0f} QPS")
+    print(f"÷ 0.7 安全水位(压测拐点×0.7 反推) = 建议容量 {cap:,.0f} QPS")
+    print("下一步: 压测验证拐点(eng-performance 阶梯加压),估算只定采购量级不定 SLA。")
+
+
+def cmd_storage(a):
+    daily = a.rows_per_day * a.row_bytes
+    raw = daily * a.days
+    total = raw * a.replicas * a.index_factor
+    print(f"日增 {a.rows_per_day:,} 行 × {a.row_bytes}B = 日增 {fmt_bytes(daily)}")
+    print(f"× 保留 {a.days} 天 = 裸数据 {fmt_bytes(raw)}")
+    print(f"× 副本 {a.replicas} × 索引膨胀 {a.index_factor}(1.3–2) = 总占用 {fmt_bytes(total)}")
+    print(f"+ 50% 余量 → 规划 {fmt_bytes(total * 1.5)}")
+    print("提醒: 冷热分层与归档可大幅砍这个数(eng-database 三板斧/eng-infra 生命周期)。")
+
+
+def cmd_conn(a):
+    need = a.instances * a.pool
+    pct = need * 100 / a.db_max
+    print(f"实例 {a.instances} × 池大小 {a.pool} = 需要连接 {need}")
+    print(f"DB 上限 {a.db_max} → 占用 {pct:.0f}%{'  <== 超 50% 余量红线,砍池或加库' if pct > 50 else '(≤50% 合规)'}")
+    print("提醒: 池不是越大越好(eng-database 公式 核数×2+磁盘数);PG 场景必须过 pgbouncer(db-postgres)。")
+
+
+def cmd_bandwidth(a):
+    mbps = a.qps * a.payload_kb * 8 / 1024
+    print(f"{a.qps:,} QPS × {a.payload_kb}KB × 8bit = {mbps:,.0f} Mbps(单向)")
+    print(f"+ 50% 余量 → 规划 {mbps * 1.5:,.0f} Mbps;跨机房/公网按双向与突发再评。")
+
+
+def cmd_pool(a):
+    cpu_bound = a.cores + 1
+    io_bound = int(a.cores * (1 + a.wait_ratio))
+    print(f"CPU 密集参考: 核数+1 = {cpu_bound}")
+    print(f"IO 密集参考: 核数×(1+等待/计算={a.wait_ratio}) = {io_bound}")
+    print("纪律: 队列必须有界+拒绝策略显式+池指标上监控(dev-java 并发节);公式是起点,画像是终点。")
+
+
+def cmd_transfer(a):
+    secs = a.size_mb * 1024 / a.kbps
+    print(f"{a.size_mb}MB ÷ {a.kbps}KB/s = {secs:,.0f}s ≈ {secs / 60:.1f} 分钟")
+    print(f"超时建议 ≥ {secs * 1.5:,.0f}s(×1.5);固定 30s 超时在慢链路=必失败(eng-complex-env 铁律)。")
+    print("上传 100% ≠ 送达:校验和两端比对才算(env-offline 三点校验)。")
+
+
+def selftest():
+    ns = argparse.Namespace
+    cmd_qps(ns(dau=100000, actions=20, peak=5))
+    cmd_storage(ns(rows_per_day=500000, row_bytes=512, days=730, replicas=3, index_factor=1.5))
+    cmd_conn(ns(instances=20, pool=30, db_max=1000))
+    cmd_bandwidth(ns(qps=2000, payload_kb=8))
+    cmd_pool(ns(cores=8, wait_ratio=4))
+    cmd_transfer(ns(size_mb=100, kbps=100))
+    print("\nselftest ok")
+
+
+def main():
+    if "--selftest" in sys.argv:
+        return selftest()
+    p = argparse.ArgumentParser(description="容量估算(公式过程可评审)")
+    sub = p.add_subparsers(dest="cmd", required=True)
+    q = sub.add_parser("qps"); q.add_argument("--dau", type=int, required=True); q.add_argument("--actions", type=float, required=True); q.add_argument("--peak", type=float, default=5)
+    s = sub.add_parser("storage"); s.add_argument("--rows-per-day", type=int, required=True); s.add_argument("--row-bytes", type=int, required=True); s.add_argument("--days", type=int, default=730); s.add_argument("--replicas", type=int, default=3); s.add_argument("--index-factor", type=float, default=1.5)
+    c = sub.add_parser("conn"); c.add_argument("--instances", type=int, required=True); c.add_argument("--pool", type=int, required=True); c.add_argument("--db-max", type=int, default=1000)
+    b = sub.add_parser("bandwidth"); b.add_argument("--qps", type=float, required=True); b.add_argument("--payload-kb", type=float, required=True)
+    t = sub.add_parser("pool"); t.add_argument("--cores", type=int, required=True); t.add_argument("--wait-ratio", type=float, default=4)
+    tr = sub.add_parser("transfer"); tr.add_argument("--size-mb", type=float, required=True); tr.add_argument("--kbps", type=float, required=True)
+    a = p.parse_args()
+    {"qps": cmd_qps, "storage": cmd_storage, "conn": cmd_conn, "bandwidth": cmd_bandwidth, "pool": cmd_pool, "transfer": cmd_transfer}[a.cmd](a)
+
+
+if __name__ == "__main__":
+    main()

package/skills/eng-automation/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: eng-automation
+description: 工程自动化链（五层自动化模型:本地钩子→CI 门禁→机器人→定时例程→自愈动作→ROI 判据与三次法则→脚手架与 golden path→机器人清单→自愈白名单分级→自动化债治理→覆盖率度量）。工程链自动化深耕:研发流程提效立项、重复劳动清点、机器人/例程建设、自动化脚本失控时载入。流水线工程细则由 cicd-pipeline、办公例程由 office-automation 承接。
+version: 1.0.0
+---
+
+# 工程自动化链
+
+engineering-chain 的自动化子链。目标:**把工程师从例行劳动里解放到判断性劳动**;
+判据:凡是步骤可写清的重复劳动都是自动化候选,凡是需要权衡的判断都不许全自动。
+
+## 五层自动化模型（从近到远,逐层升级）
+
+| 层 | 载体 | 典型内容 | 纪律 |
+|---|---|---|---|
+| L1 本地 | pre-commit/脚本/别名 | 格式化/敏感信息扫描/裸 TODO 拦截 | 秒级才有人用(dev-toolchain) |
+| L2 门禁 | CI 流水线 | 构建/测试/扫描/体积预算 | 工程实现见 **cicd-pipeline** |
+| L3 机器人 | 事件驱动 bot | PR 检查评论/依赖升级/构建红灯播报 | 见机器人清单 |
+| L4 例程 | 定时任务 | 周报巡检/清理/台账提醒 | 平台例程能力承载(office-automation) |
+| L5 自愈 | 告警触发动作 | 自动扩容/重启/切流/降级 | **白名单分级,见自愈节** |
+
+演进纪律:先 L1L2 打牢(个人与团队基本盘)再上 L3L4(组织资产),L5 最后(要预案与演练背书)。
+
+## ROI 判据（立项前先算）
+
+- **三次法则**:同一操作手工干到第三遍→脚本化;脚本被 3 人以上使用→产品化(加参数校验/文档/Owner);
+- 账要算全:收益=频率×单次耗时×人数;成本=开发+**维护**(环境变化就要修)——高频稳定流程收益最大,低频且易变的流程自动化常亏本(留清单化的手工步骤反而对);
+- 隐性收益计入:消灭等待(自动触发替人盯)、消灭遗漏(清单必过)、留痕合规;
+- **自动化债**:脆弱脚本(硬编码路径/无错误处理/无人敢动)也是债,进技术债台账(eng-architecture)同管。
+
+## 脚手架与 Golden Path
+
+- 项目模板仓库:新服务从模板起步(目录结构/CI 配置/日志与监控接入/健康检查/README 骨架全带)——**新项目 30 分钟可部署第一版是脚手架的验收标准**;
+- 模板要活:模板更新有 Owner,存量项目漂移检测(模板升级公告+迁移脚本);
+- 代码生成judgment:样板代码(CRUD/接口层/客户端 SDK)从契约生成(api-design 同源),**生成物不手改**(要改改模板或生成器,手改=下次生成即冲突);
+- Golden path 文档化:官方推荐路径(选型+模板+流程)让 80% 场景零决策直行,偏离 golden path 才需要评审(eng-architecture 收敛纪律的执行面)。
+
+## 机器人清单（L3,按收益排序建设）
+
+- CI 看护 bot:红灯即时通报到群+@最近提交人,连续红 >2h 升级(engineering-chain 例程);
+- 依赖升级 bot:锁文件级升级 PR 自动开(带 changelog 摘要),小版本自动合入判据(测试全绿+周知),大版本转人工(dependency-upgrade);
+- PR 协作 bot:体积/覆盖率/性能基线对比自动评论;超 3 天无动作的 PR 提醒;巨型 PR(>800 行)自动提示拆分;
+- 发布 bot:发布单自动生成(变更列表/关联工单)、发布窗口冲突提醒(eng-release 变更日历);
+- 工单分诊 bot:报障自动带上环境与日志摘要模板,缺信息自动追问(itsm-ops 承接);
+- **AI 加持判据**(eng-ai):摘要/分类/初诊类任务适合 LLM(PR 描述生成/坏例聚类/告警聚合摘要);判定类(能不能合入)只给建议不给决定。
+
+## 定时例程（L4,平台例程能力落地）
+
+工程域高价值例程配方(engineering-chain 例程节的执行面):
+依赖 CVE 周报/慢 SQL 周报/告警疲劳度月检/成本月报/证书与域名到期巡检/技术债季检/
+无主资源与僵尸开关清扫/文档保鲜期到期提醒(eng-docs)——
+每条例程四要素:触发时刻/产出物(报告落到哪)/异常升级路径/Owner。**没有 Owner 的例程=定时垃圾制造器**。
+
+## 自愈自动化（L5,白名单分级）
+
+| 级 | 动作类型 | 授权 |
+|---|---|---|
+| 只读诊断 | 抓栈/抓日志/快照采集 | 告警触发自动执行,永远安全 |
+| 无损缓解 | 摘除单实例/重启单 Pod/清理磁盘日志 | 白名单内自动,**执行即通报**(不是静默) |
+| 有损变更 | 扩容/切流/开降级开关 | 预案编号+人一键确认(半自动);演练过的预案才进此级 |
+| 危险动作 | 数据修复/回滚/权限变更 | 永不自动,人走 eng-ops 流程 |
+
+自愈三前提:动作幂等、有熔断(同一动作 N 分钟内只执行一次,防抖动风暴)、有全局开关(自愈系统自身失控时一键停)。
+
+## 自动化资产治理
+
+自动化脚本=代码:入库、评审、有测试(至少冒烟)、有 Owner;
+**失败必须告警**——静默失败的自动化比没有更糟(以为有人管其实没人管);
+季度盘点:执行成功率/人工干预次数/失效脚本下线;交接纪律(人走脚本不留孤儿)。
+
+## 度量
+
+自动化覆盖率(发布步骤自动化占比/测试自动化占比)、人工例行工时趋势(月度采样)、
+例程与 bot 的干预率(自动化产出被人工修正的比例——高=不可信,治理或降级为提醒);
+与 eng-efficiency 效能度量联动(自动化是改善 DORA 前置时间的主力)。
+
+**作业包**:`references/automation-inventory.md`(立项 ROI 卡/资产台账(失败必告警)/例程四要素/自愈白名单登记/高价值例程选单);
+`references/routine-presets.md`(**工程巡检例程预设**:基于平台 /schedule 真实机制的 10 条复制即装配方——依赖安全/密钥扫描/数据库与缓存健康/AI 质量哨兵/成本周报/K8s 晨检/证书到期/保鲜季检,--yolo 安全纪律先读)。
+
+## 使用纪律
+
+先标准化后自动化(乱流程自动化=把乱加速);判断性决策永远留人(自动化提供信息与建议);
+每次"手工救火"复盘必问:哪一步可以自动化?(eng-ops 三回写延伸)——
+**自动化的终态不是无人,是人只出现在值得人出现的地方**。

package/skills/eng-automation/references/automation-inventory.md

@@ -0,0 +1,38 @@
+# 自动化资产台账与立项卡（eng-automation 落笔件）
+
+## 1. 自动化立项卡(三次法则触发后填)
+
+| 项 | 内容 |
+|---|---|
+| 流程名 | __(先标准化后自动化——乱流程自动化=把乱加速) |
+| 现状 | 频率 __/周 × 单次 __ 分钟 × __ 人 = 月耗 __ 小时 |
+| 层级 | □L1 本地钩子 □L2 CI 门禁 □L3 机器人 □L4 例程 □L5 自愈 |
+| ROI | 收益 __ 小时/月;开发 __ 天+维护 __ 时/月;回本 __ 月(高频稳定赚,低频易变亏) |
+| 判断点留人 | 自动化到哪步为止,哪步必须人拍板:__ |
+
+## 2. 自动化资产台账(季度盘点用)
+
+| 名称 | 层级 | Owner | 触发 | 产出物 | 失败告警到 | 成功率(近月) | 状态 |
+|---|---|---|---|---|---|---|---|
+| 例:依赖CVE周报 | L4 | __ | 周一 09:00 | 报告→群 | __ | __% | 在役/待修/下线 |
+
+> 铁律:失败必须告警(静默失败的自动化比没有更糟);无 Owner 的例程=定时垃圾制造器;脚本入库有评审。
+
+## 3. 例程四要素登记(L4,平台例程能力落地)
+
+- 触发时刻:__ / 产出物落到:__ / 异常升级路径:__ / Owner:__
+
+## 4. 自愈动作白名单登记(L5,逐条审批)
+
+| 动作 | 级别(只读诊断/无损缓解/有损变更) | 幂等? | 熔断(N 分钟一次) | 全局开关 | 演练日期 |
+|---|---|---|---|---|---|
+
+> 有损级=预案编号+人一键确认;危险动作(数据修复/回滚/权限)永不自动。
+
+## 5. 工程域高价值例程配方速查(engineering-chain 例程节的选单)
+
+CI 看护 / 依赖 CVE 周报 / 慢 SQL+Redis bigkey+ES 对账周扫 / 告警疲劳度月检 /
+SLO 错误预算周报 / 成本月报(infra+token) / AI 质量哨兵(漂移金丝雀日跑) /
+数据库巡检(长事务/自增水位/复制槽/XID) / 证书与许可到期 / 客户升级日历与 EOL /
+技术债季检 / 文档保鲜期 / 单点模块与会议审计季盘
+——每条接对应链的作业包脚本,产出留档比趋势。

package/skills/eng-automation/references/routine-presets.md

@@ -0,0 +1,73 @@
+# 工程巡检例程预设（eng-automation 落笔件:基于平台 /schedule 真实能力,复制即装）
+
+平台机制(以当前版本为准):`/schedule add "<cron>" "<提示词>"` 登记到 `~/.huicai/schedule.json`,
+生成 crontab 行交系统 cron 运行(`huicai -p "<提示词>" --yolo --plain`,日志在 `~/.huicai/schedule-<id>.log`);
+`/schedule list` 查看并复制 crontab 行,`/schedule remove <id>` 删除。
+
+## 安全纪律(先读再装,--yolo 运行的铁律)
+
+- **提示词必须自限"只读巡检+报告落盘"**:例程提示词里明写"只读操作,不做任何变更/修复/提交"——
+  自动化分层 L4 例程只产报告,处置永远留给人(eng-automation 白名单四级);
+- 凭证不进提示词:数据库/Redis 连接信息走环境变量或本机配置(sec-auth/eng-infra 密钥纪律);
+- 报告目录统一 `巡检报告/YYYY-MM-DD-<主题>.md`(留档比趋势);**失败也要落报告**(静默失败的自动化比没有更糟);
+- 每条例程有 Owner,进自动化台账(automation-inventory.md)。
+
+## 预设清单(在目标项目目录下执行 /schedule add;按需改路径与频率)
+
+**1. 依赖安全周报**(周一 09:00,eng-security SLA)
+```
+/schedule add "0 9 * * 1" "只读巡检:载入 eng-security 技能,对本仓库各锁文件跑依赖漏洞扫描(npm audit 等按栈选),按 严重/高/中 分级汇总,高危以上逐条列包名与修复版本,写入 巡检报告/$(date +%F)-依赖安全周报.md;不做任何升级或变更"
+```
+
+**2. 密钥泄漏周扫**(周日 22:00,dev-toolchain)
+```
+/schedule add "0 22 * * 0" "只读巡检:载入 dev-toolchain 技能,用其作业包 secret-scan.sh 扫描本仓库全部源码目录,命中项写入 巡检报告/$(date +%F)-密钥扫描.md 并在报告开头标注'真密钥按已泄露处置(吊销重发)';零命中也要写报告说明扫描范围;不修改任何文件"
+```
+
+**3. 数据库健康周检**(周二 07:30,db-mysql/db-postgres)
+```
+/schedule add "30 7 * * 2" "只读巡检:载入 db-mysql 技能,用作业包 mysql-health.sql 对巡检配置中的库执行(凭证走本机配置不写入报告),重点摘录:长事务/锁等待/自增水位>70%/碎片 TOP,与上周报告对比变化,写入 巡检报告/$(date +%F)-MySQL健康.md;只读查询,不执行任何 DML/DDL"
+```
+(PG 版同构:载 db-postgres 用 pg-health.sql,重点 XID age 与复制槽。)
+
+**4. 缓存与搜索周扫**(周三 07:30,db-redis/db-es)
+```
+/schedule add "30 7 * * 3" "只读巡检:载入 db-redis 与 db-es 技能,分别用 redis-health.sh(错峰时段可加 --scan)与 es-health.sh 检查巡检清单中的实例,异常项(碎片率/淘汰/未分配分片/磁盘水位)汇总写入 巡检报告/$(date +%F)-缓存搜索健康.md;只读命令"
+```
+
+**5. AI 质量哨兵**(每日 07:00,ai-eval/ai-mlops 漂移金丝雀)
+```
+/schedule add "0 7 * * *" "只读巡检:载入 ai-eval 技能,用作业包 eval-runner.py 跑金丝雀题集 评测/canary.jsonl(--baseline 上次结果,--out 覆盖留档),新挂案例即在报告开头标红,写入 巡检报告/$(date +%F)-AI质量哨兵.md;只评测不改提示不改配置"
+```
+
+**6. Token 成本周报**(周五 17:00,ai-mlops)
+```
+/schedule add "0 17 * * 5" "只读巡检:载入 ai-mlops 技能,导出本周用量数据后用 token-cost-calc.py 出维度归因与单位任务成本,对比预算与上周,写入 巡检报告/$(date +%F)-AI成本周报.md;只统计不做降级变更"
+```
+
+**7. 前端体积周检**(周四 08:00,dev-frontend)
+```
+/schedule add "0 8 * * 4" "只读巡检:构建产物存在则载入 dev-frontend 技能,用 bundle-budget.py 检查 dist 目录(预算沿用项目约定),超限文件与总量趋势写入 巡检报告/$(date +%F)-前端体积.md;不触发构建不改代码"
+```
+
+**8. K8s 晨检**(工作日 08:30,infra-k8s)
+```
+/schedule add "30 8 * * 1-5" "只读巡检:载入 infra-k8s 技能,用 k8s-triage.sh 采集集群快照(-o 巡检报告/k8s),Pending/CrashLoop/重启榜/Warning 事件摘要写入 巡检报告/$(date +%F)-K8s晨检.md;只读 kubectl,不改任何资源"
+```
+
+**9. 证书与许可到期巡检**(每日 08:00,infra-gateway/env-offline)
+```
+/schedule add "0 8 * * *" "只读巡检:读取 运维/证书清单.md 的域名与证书列表,逐个检查到期日(openssl 只读连接),30 天内到期的列入报告开头红区并@负责人栏,写入 巡检报告/$(date +%F)-证书到期.md;不做续期操作"
+```
+
+**10. 文档保鲜与台账季检**(每季首月 1 日 09:30,eng-docs/eng-architecture)
+```
+/schedule add "30 9 1 1,4,7,10 *" "只读巡检:扫描仓库文档的保鲜头部(最后验证日期),超保鲜期清单+技术债台账到期项+无 Owner 例程清单,写入 巡检报告/$(date +%F)-季度保鲜与台账.md;只列清单不改文档"
+```
+
+## 装配与治理
+
+- 批量装配:上述命令逐条在对应项目目录执行(cwd 会被记录);`/schedule list` 取 crontab 行粘贴进 `crontab -e`;
+- 主机侧批量巡检(多台 Linux 用 quick-triage)走 **ops-fleet** 的 batch-exec-guard(只读命令也过金丝雀习惯);
+- 例程上线后第一周人工核对报告质量(eng-automation 干预率纪律),无人看的报告=定时垃圾,砍或改;
+- 报告异常的**处置永远是人**:例程发现→工单/群提醒→人按对应链处置(L4 产报告,L5 自愈另走白名单审批)。

package/skills/eng-collaboration/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: eng-collaboration
+description: 工程协作链（评审文化与 SLA(24h 首响/400 行上限/对事给理由)→结对与 mob 判据→巴士系数盘点与知识传承(轮岗/影子/分享沉淀)→跨团队依赖契约与升级路径→会议工程时间盒→异步协作默认与专注块→技术分歧处理(证据+决策人+disagree and commit)→新人融入设计）。工程链协作子链:评审拖沓、知识都在一个人脑里、跨团队扯皮、会议吞噬产能、技术争论无休时载入。
+version: 1.0.0
+---
+
+# 工程协作链
+
+engineering-chain 的协作子链。工程是团队运动:流程与工具的上限,由协作质量决定;
+本链管"人与人的接口设计"——和 API 一样,要有契约、有 SLA、有版本。
+
+## 评审文化（协作的高频接口）
+
+- **SLA**:首次响应 ≤24h(阻塞别人=最贵的等待,eng-efficiency 价值流第一杀手);紧急 PR 走 IM 直呼+说明为何急;
+- 规模纪律:单 PR ≤400 行有效变更(超了评审质量断崖跌,"LGTM 眼盲"),大改动拆序列 PR(eng-develop 一 PR 一事);
+- 评审姿势:对事不对人、指出问题给理由与建议("这里会 NPE,建议 Optional"而非"这写得不行");用问句探意图("这里不用缓存是有意的吗");**挑刺要挑大的**(架构与正确性优先,格式交给工具,dev-toolchain);
+- 作者义务:自评先行(eng-develop)、PR 描述讲清 why、逐条回应评论(采纳或说明不采纳理由,不许已读不回);
+- 批准纪律:approve=我愿意共担这段代码的责任;看不懂的部分说看不懂(装懂放行=虚假防线);
+- 分歧超两轮评论→当面/语音十分钟(文字对喷一下午不如通话十分钟)。
+
+## 结对与 mob 判据
+
+上结对的信号:复杂设计落地初期/疑难排障(四只眼睛看栈)/新人带教/单点模块交接——**按需结对,不教条全天候**;
+mob(全组围一屏)只用于:关键决策落地/全组都该懂的核心改造;
+轮换纪律:结对定时换手(驾驶员/领航员),防单向表演;
+远程结对用共享会话工具,效果打折要认,高价值场景才开。
+
+## 巴士系数与知识传承
+
+- **单点模块季度盘点**:每个模块标"几个人敢改"(=1 的进风险清单,eng-research 巴士系数落点);治理三招:结对开发/文档补课(eng-docs)/轮岗安排;
+- 影子机制:值班影子(新人跟班,eng-ops)/发布影子/评审影子——看三遍、做一遍、教一遍;
+- 内部分享:双周 30 分钟,主题从实战来(事故复盘/新链新技能/踩坑);**录播+文档沉淀**(knowledge-sop),不沉淀的分享=一次性消费;
+- 轮岗判据:核心模块两年一轮候选(防知识板结),轮岗成本(3 个月产能折损)与单点风险权衡,关键期不轮。
+
+## 跨团队协作契约
+
+- **依赖显式化**:跨团队依赖开"依赖请求单"(要什么/何时要/接口人/承诺日期),口头拜托=没有依赖(eng-planning 外部依赖第一杀手的治理面);
+- 接口冻结窗口:联调前 N 天接口冻结(再改走变更评审,api-design 契约纪律);
+- 联调预约制:双方排期对齐+环境与测试数据提前备(eng-planning 联调工时);
+- 升级路径:执行层两轮对不齐→各自上升一层对齐(**升级不是告状,是止损**,文化要讲明);
+- 跨团队复盘:事故涉多团队时联合复盘,时间线拼全图(eng-ops 无指责纪律跨团队适用)。
+
+## 会议工程（会议是最贵的同步原语）
+
+- 站会 15 分钟三问:昨天完成/今天计划/**有什么阻塞**(阻塞是站会的第一产出,会后立刻拆解);站会不讨论方案(超 2 分钟的话题拉小会);
+- 决策会三件套:会前有底稿(异步先读,会上不念稿)/会中有决策人(吵不拢谁拍板,**缺席关键人则改期,不开"再对一次"的会**)/会后有纪要(决策+理由+行动项,meeting-minutes);
+- 时间盒纪律:默认 30 分钟起排(不是 60);到点未决→记录分歧点约下一步,不拖堂;
+- 会议审计季度做:例会逐个问"砍掉会怎样"——答不出恶果的砍(eng-efficiency 专注时间)。
+
+## 异步协作默认
+
+- 文档先行:讨论带底稿(evidence 与选项列好),评论异步收敛,会议只处理真分歧(eng-docs docs-as-code);
+- 打断分级:P1 电话/急事 IM 强提醒并说清"何事+需要什么+何时要"/常规异步不催——**"在吗"是最差的打断**(说不清成本挂着焦虑);
+- 专注块保护:团队约定免打扰时段(如上午),会议集中排下午;深工作被打断恢复要 20 分钟,连环打断=全天零产出;
+- 状态透明:任务看板即进度(问进度先看板),减少"进展如何"式打断(TaskList/工单系统)。
+
+## 技术分歧处理
+
+分歧上证据:各自给数据/POC/案例(eng-research 一手信息纪律),观点对观点=嗓门赛;
+时间盒:证据仍不能收敛→**预先声明的决策人拍板**(架构域=架构 Owner,eng-architecture ADR 记录分歧与理由);
+**disagree and commit**:拍板后全力执行,保留复盘权(ADR 回退条件是"我保留意见"的正确出口);
+反刍禁止:已决事项无新证据不重开(新证据=数据变了,不是"我还是觉得")。
+
+## 新人融入设计
+
+首日环境跑通(eng-docs 上手路径+dev-toolchain 及格线)/首周首个小 PR(精心挑的低风险真任务,走全流程建立信心)/
+首月影子值班+模块导读;导师制:指定导师(答疑第一入口)+每周 1:1;
+**新人是流程的免费审计**:他们卡住的每一步都是文档或流程的 bug(eng-docs 回写)——欢迎提问,更要把答案沉淀。
+
+**作业包**:`references/collab-templates.md`(依赖请求单/决策纪要/评审 SLA 约定/单点盘点表/会议审计表/新人融入卡)。
+
+## 使用纪律
+
+评审 SLA 与单点清单进团队看板(eng-efficiency 采样);跨团队依赖必有请求单;
+决策必有决策人与纪要;每季会议审计+单点盘点各一轮——
+**协作的复利来自把"默契"变成"契约":人可以换,接口不塌。**

package/skills/eng-collaboration/references/collab-templates.md

@@ -0,0 +1,43 @@
+# 协作契约模板包（eng-collaboration 落笔件:把默契变成契约）
+
+## 1. 跨团队依赖请求单(口头拜托=没有依赖)
+
+| 项 | 内容 |
+|---|---|
+| 请求方/接口人 | __ / __ |
+| 要什么 | __(接口/数据/评审/资源,验收标准可判定) |
+| 何时要 | __(关键路径上?延期影响:__) |
+| 承诺方/承诺日期 | __ / __(写进双方排期,eng-planning 外部依赖表) |
+| 状态 | 待承诺/已承诺/交付/延期(延期即升级:两层各上升一级对齐) |
+
+## 2. 决策纪要模板(口头决策=没有决策)
+
+- 议题:__;决策人:__(会前已明确,缺席关键人则改期)
+- 底稿链接:__(会前异步读,会上不念稿)
+- **决策**:__;理由:__;放弃的备选与原因:__(防考古重问)
+- 分歧记录:__(disagree and commit;复盘条件:出现 __ 证据时重议)
+- 行动项:| 事 | Owner | 期限 |
+- 重大技术决策 → 落 ADR-__(eng-architecture)
+
+## 3. 评审 SLA 团队约定(贴在团队文档首页)
+
+- 首响 ≤24h(紧急走 IM 直呼+说明为何急);单 PR ≤400 行
+- 作者自评先行;评论逐条回应;分歧超两轮→十分钟通话
+- approve=愿意共担责任;看不懂就说看不懂
+
+## 4. 单点模块盘点表(季度,巴士系数治理)
+
+| 模块 | 敢改的人数 | 风险(=1 标红) | 治理动作(结对/文档/轮岗) | 期限 | 复盘 |
+|---|---|---|---|---|---|
+
+## 5. 会议审计表(季度,砍会专用)
+
+| 例会 | 频率×时长×人数=月耗时 | 产出(决策/行动项数) | 砍掉会怎样 | 处置(保留/减频/改异步/砍) |
+|---|---|---|---|---|
+
+## 6. 新人融入计划卡
+
+- 首日:环境跑通(README 快速开始;卡点记录→文档 bug)
+- 首周:架构导读 __;首个小 PR:__(低风险真任务,走全流程)
+- 首月:影子值班 __ 轮;导师 __ 每周 1:1
+- 新人反哺:上手卡点清单 → eng-docs 回写(新人是流程的免费审计)

package/skills/eng-complex-env/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: eng-complex-env
+description: 复杂环境作业链（全链横切纪律:进场侦察清单→受限网络作业(限速/超时按载荷缩放/校验和送达确认)→低权限与审批制作业→老旧约束共存→长任务断点续作与幂等重跑→每个关键操作的降级 PlanB→目标环境等价验证→现场作业纪律;路由孙链:离线内网/信创适配/私有化交付）。任何技能进入受限网络、离线内网、低权限、审批制生产、老旧系统等复杂环境执行任务前先载入本链——理想环境的流程在复杂环境会失效,本链是全链的降级手册。
+version: 1.0.0
+---
+
+# 复杂环境作业链
+
+engineering-chain 的横切子链,**全链适用**:其余每条链的流程都默认"网络通畅、权限充足、工具齐全、环境可复现"——
+复杂环境里这些假设逐条失效。本链回答:假设失效时,任务照样完成。
+
+## 孙链路由表
+
+| 环境形态 | 孙链 | 一句定位 |
+|---|---|---|
+| 离线/隔离内网 | **env-offline** | 依赖离线化/摆渡纪律/离线安装升级/内网证书与时间/诊断包自助 |
+| 信创国产化 | **env-xinchuang** | 芯片×OS×DB×中间件适配矩阵/达梦金仓深坑/ARM 多架构/测评验收 |
+| 私有化交付 | **env-private-deploy** | 版本碎片治理/环境预检/配置档案/多客户升级编排/远程受限支持 |
+
+## 进场侦察清单（复杂环境作业第一步,别带着假设开工）
+
+- **网络**:出网可达性(哪些域名/端口通)/代理与认证方式/**带宽实测**(scp 一个 10MB 文件测真实速率,别信标称——限速 50KB/s 与 100MB/s 是两种作业方式)/是否单向(能拉不能推);
+- **权限**:root/sudo 有无;能否装软件、起容器、开端口;生产操作是否审批制(审批链多长、一次审批的范围);
+- **工具**:目标机上有什么(curl?python?tar?)——**清点可用工具再定方案**,方案依赖的工具现场没有=白设计;
+- **版本约束**:OS/运行时/依赖版本是否锁死(不可升级的约束进方案前提);
+- **窗口**:变更窗口(只能周日凌晨?)/冻结期/现场人员可配合时段;
+- **数据**:敏感级与出域规则(日志能不能带出?eng-security 分级)。
+侦察结果写成**环境档案**(eng-docs),下次进场不重摸;方案评审必附环境档案(拿理想环境方案上会=返工预定)。
+**作业包**:`scripts/env-recon.sh`(read_skill_file 读取→传目标机 `sh env-recon.sh` 执行,只读零依赖;`-H host:port` 探内网连通、`-u URL` 实测带宽、`-o` 落盘)——输出即环境档案底稿,红黄灯直指受限项;
+`references/env-dossier-template.md`(环境档案归档模板:网络实测/权限窗口/工具约束/保底方案表/变化记录——侦察产物落到这里,下次进场不重摸)。
+
+## 受限网络作业纪律
+
+- **超时按载荷缩放**:传输/上传超时=载荷大小÷实测带宽×1.5,固定 30s 超时在慢链路上传大文件=必失败——一切带传输的操作先算这笔账;
+- 传输策略:压缩先行(文本类数倍收益)/分卷(单文件失败重传代价小)/**断点续传**(rsync/分段上传,闪断不从头);
+- **送达确认**:上传进度 100% ≠ 对端可用——校验和(sha256)两端比对+对端解包验证才算送达;
+- 依赖获取:私服/镜像源优先(dev-toolchain);现场无网→离线包预制(env-offline);
+- 慢链路下的工作编排:大传输放后台并行推进其他任务,别让人和任务一起等文件。
+
+## 低权限与审批制作业
+
+- 无 root 方案库:用户态安装(语言运行时 portable 版/~/.local 前缀)/无 docker 用用户态容器或直接进程/**方案设计时就按"最低可用权限"设计**,要高权限的步骤单列(审批只审这几步);
+- 审批制生产:操作打包过审(一次审批含:操作清单+验证方式+**回滚步骤同批提交**——回滚再走一遍审批=事故拖长一倍,eng-ops 变更三要素);
+- 借权作业红线:用别人的账号操作=审计断链,宁可等授权(eng-security 留痕)。
+
+## 老旧约束共存
+
+不能升级的老运行时(JDK8/老 glibc/Windows Server 2012):**隔离优于硬扛**——老组件圈起来(独立进程/机器),新代码新环境,边界走接口(eng-legacy 绞杀思路);
+新工具链兼容降级:构建产物按目标环境最低版本编译(语言链交叉编译/兼容目标设置);
+"现场只有 XX 版本"进环境档案与 CI 矩阵(cicd-pipeline 按真实目标环境配矩阵,不是只测最新)。
+
+## 长任务纪律（断点续作与幂等重跑）
+
+复杂环境任务常跑数小时且会被打断(网络闪断/窗口到期/审批中断)——设计成**可恢复**:
+分段落盘(每阶段产物落盘,重跑从断点起——eng-data-platform 中间表纪律的通用化)/
+幂等重跑(重复执行不产生副作用,arch-distributed 幂等四模式)/
+进度外显(做到哪一步有记录,接手的人或重连的会话能续上)/
+**会话中断预案**:长操作放 screen/tmux 或后台化+日志落盘(SSH 断了任务还在,回来看日志)。
+
+## 降级路径设计（每个关键操作的 PlanB）
+
+自动化不可用→**手册化清单**(自动化脚本的每一步同时维护人工版,eng-docs Runbook 标准:新人照着能做);
+在线服务不可用→离线替代(文档离线包/依赖离线仓);
+工具缺失→原生替代(没有 jq 用 python -c,没有 rsync 用 scp+校验——**方案库按"目标机只有 POSIX 基础命令"准备保底版**);
+降级路径也要测:PlanB 没演练=没有 PlanB(eng-reliability 同则)。
+
+## 目标环境等价验证
+
+**本机跑通≠现场跑通**:交付前在目标环境等价物验证(同 OS 版本容器/同架构机器/同网络策略模拟——限速用 tc 模拟,离线用断网容器);
+环境差异高发清单:字符集与 locale/时区/文件路径与大小写敏感/代理环境变量/DNS 解析差异/SELinux 与防火墙;
+等价环境建不出来=风险声明+现场预留调试时间(排期里写明,eng-planning)。
+
+## 现场作业纪律
+
+改前快照(配置/数据/状态,能回去的底线);操作留痕加严(命令与输出全程记录,复杂环境的"为什么坏了"全靠它);
+**撤退条件预定义**:干到什么情况停手撤退(窗口剩 30 分钟未过半→回滚,现场不纠结,eng-release 回滚量化同源);
+联络线:现场/远程支持/客户三方联络人与升级路径(eng-ops 作战通道的现场版);
+一次只改一个变量在复杂环境加倍适用(现场变量本来就多,eng-performance)。
+
+## 使用纪律
+
+进复杂环境的任务先过侦察清单,方案带环境档案评审;带传输的操作超时按载荷算;
+长任务必可断点续作;关键操作必有 PlanB 且演练过;
+每次现场翻车回写:环境差异清单+保底方案库——**复杂环境的复利=环境档案与保底方案库,让下一次进场从 60 分起步**。

package/skills/eng-complex-env/references/env-dossier-template.md

@@ -0,0 +1,52 @@
+# 环境档案模板（eng-complex-env 落笔件:env-recon.sh 产物的归档格式,下次进场不重摸）
+
+> 一环境一档;方案评审必附;每次进场后更新"变化记录"。存放:项目 `环境档案/<客户或环境名>.md`
+> (私有化场景并入客户档案 delivery-templates,信创组合并记 adaptation-matrix 格号)。
+
+## 1. 概要
+
+| 项 | 内容 |
+|---|---|
+| 环境名/用途 | __(生产/预发/客户现场) |
+| 隔离形态 | □在线 □审批出网 □单向闸 □全离线(env-offline 作业方式) |
+| 侦察报告 | env-recon 输出:__(日期 __;红黄灯摘要:__) |
+| 档案 Owner/最后核实 | __ / __(进场前若超 90 天,先重跑 env-recon) |
+
+## 2. 网络(决定一切传输方案)
+
+- 出网:□无 □白名单(域名:__) □代理(地址/认证:__)
+- **带宽实测**:__ KB/s(测法:__;日期:__)——传输超时一律按此换算(capacity-calc transfer)
+- 内网关键连通:__:__ 通/不通(db/redis/registry/…)
+- DNS:__;特殊(ndots/内网域):__
+
+## 3. 权限与窗口
+
+- 账号形态:□root □sudo(免密?) □普通用户;审批链:__(一次审批范围:__;时长:__)
+- 变更窗口:__;冻结期:__;现场可配合时段:__
+- 堡垒机/跳板:__(留痕方式:__)
+
+## 4. 工具与版本约束
+
+- 目标机已有:__(env-recon 工具清单粘贴)
+- 缺失且方案依赖:__ → 保底替代:__(PlanB 方案库)
+- 锁死版本:OS __ /运行时 __ /不可升级项:__(方案前提)
+
+## 5. 数据与合规
+
+- 数据敏感级:__;日志出域规则:__(脱敏流程:__)
+- 等保等级与到期:__(sec-compliance);行业约束:__
+
+## 6. 保底方案与断点设计(本环境专属 PlanB)
+
+| 关键操作 | 首选方案 | PlanB(手册化/离线替代) | 演练过? |
+|---|---|---|---|
+| 传大文件 | | 分卷+校验(bundle-manifest) | |
+| 装依赖 | | 离线仓/预制包 | |
+| 远程排障 | | 诊断包自助采集 | |
+
+- 长任务断点方案:__(screen/tmux/nohup 可用性:__;分段落盘目录:__)
+
+## 7. 变化记录(追加式,每次进场后写)
+
+| 日期 | 变化/新坑 | 影响 | 回写(保底库/侦察脚本/本档案) |
+|---|---|---|---|