@huicai/cli 2026.712.80880 → 2026.721.0

package/skills/eng-complex-env/scripts/env-recon.sh

@@ -0,0 +1,152 @@
+#!/bin/sh
+# 复杂环境进场侦察脚本（eng-complex-env 侦察清单的可执行版）。
+# 只读、零依赖、POSIX sh：目标机只有 busybox 也能跑；工具缺失自动降级并如实报告。
+# 用法：sh env-recon.sh [-u 探测URL] [-H host:port,host:port] [-o 输出文件]
+#   -u  出网/带宽探测目标（默认跳过出网测试——离线环境不制造报错）
+#   -H  逗号分隔的内网连通性探测点（如 db 主机:3306,redis:6379）
+#   -o  报告落盘路径（默认仅 stdout）
+# 产出：环境档案底稿（进 eng-complex-env 环境档案，供方案评审附件）。
+
+URL=""; HOSTS=""; OUT=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    -u) URL="$2"; shift 2;;
+    -H) HOSTS="$2"; shift 2;;
+    -o) OUT="$2"; shift 2;;
+    *) echo "未知参数: $1 (用 -u/-H/-o)"; exit 2;;
+  esac
+done
+
+R=""    # 红灯汇总
+Y=""    # 黄灯汇总
+have() { command -v "$1" >/dev/null 2>&1; }
+say() { if [ -n "$OUT" ]; then echo "$@" >> "$OUT"; fi; echo "$@"; }
+[ -n "$OUT" ] && : > "$OUT"
+
+say "==================== 环境侦察报告 ===================="
+say "生成时间: $(date '+%Y-%m-%d %H:%M:%S') (时区 $(date '+%Z%z' 2>/dev/null))"
+say "主机: $(hostname 2>/dev/null || uname -n)"
+
+say ""
+say "---- [1/7] 系统与硬件 ----"
+say "内核: $(uname -srm 2>/dev/null)"
+if [ -r /etc/os-release ]; then
+  say "发行版: $(. /etc/os-release 2>/dev/null; echo "${PRETTY_NAME:-$NAME $VERSION_ID}")"
+else
+  say "发行版: 未知(/etc/os-release 不可读)——老系统或精简镜像"
+fi
+CORES=$( (nproc 2>/dev/null) || (sysctl -n hw.ncpu 2>/dev/null) || grep -c ^processor /proc/cpuinfo 2>/dev/null || echo "?")
+say "CPU 核数: $CORES  架构: $(uname -m 2>/dev/null)"
+if [ -r /proc/meminfo ]; then
+  MEMT=$(awk '/MemTotal/{printf "%.1fG",$2/1048576}' /proc/meminfo)
+  MEMA=$(awk '/MemAvailable/{printf "%.1fG",$2/1048576}' /proc/meminfo)
+  say "内存: 总 $MEMT / 可用 ${MEMA:-?}(看 available 不看 free)"
+else
+  say "内存: /proc/meminfo 不可读(非 Linux? $(uname -s))"
+fi
+# 容器检测
+if [ -f /.dockerenv ] || grep -qsE 'docker|kubepods|containerd' /proc/1/cgroup 2>/dev/null; then
+  say "容器环境: 是(资源限额看 cgroup 不看 free/top —— ops-linux cgroup 假象)"
+  for f in /sys/fs/cgroup/memory.max /sys/fs/cgroup/memory/memory.limit_in_bytes; do
+    [ -r "$f" ] && say "  cgroup 内存上限: $(cat "$f" 2>/dev/null)"
+  done
+else
+  say "容器环境: 否(或检测不出)"
+fi
+
+say ""
+say "---- [2/7] 权限 ----"
+say "当前用户: $(id 2>/dev/null || whoami)"
+if [ "$(id -u 2>/dev/null)" = "0" ]; then say "root: 是"
+elif have sudo && sudo -n true 2>/dev/null; then say "root: 否,但 sudo 免密可用"
+elif have sudo; then say "root: 否;sudo 存在但需密码/审批"; Y="$Y|sudo需密码"
+else say "root: 否且无 sudo —— 方案按最低权限设计(eng-complex-env 低权限节)"; Y="$Y|无sudo"; fi
+TW=/tmp/.recon_w_$$; if ( : > "$TW" ) 2>/dev/null; then say "/tmp 可写: 是"; rm -f "$TW"; else say "/tmp 可写: 否"; R="$R|/tmp不可写"; fi
+say "HOME 磁盘余量: $(df -h "$HOME" 2>/dev/null | awk 'NR==2{print $4" 可用("$5" 已用)"}')"
+
+say ""
+say "---- [3/7] 工具清单(方案依赖的工具现场没有=白设计) ----"
+FOUND=""; MISS=""
+for t in bash curl wget python3 python java node docker podman kubectl git rsync tar gzip unzip zip ss netstat lsof jq openssl systemctl crontab screen tmux sha256sum shasum; do
+  if have "$t"; then FOUND="$FOUND $t"; else MISS="$MISS $t"; fi
+done
+say "有:$FOUND"
+say "无:$MISS"
+have python3 || have python || { Y="$Y|无python"; }
+have curl || have wget || { Y="$Y|无curl/wget"; }
+have sha256sum || have shasum || have openssl || { Y="$Y|无校验和工具"; }
+have screen || have tmux || say "提示: 无 screen/tmux —— 长任务用 nohup+日志落盘(eng-complex-env 长任务纪律)"
+
+say ""
+say "---- [4/7] 网络 ----"
+say "代理环境变量: $(env 2>/dev/null | grep -iE '^(http|https|no)_proxy=' | tr '\n' ' ' || true)"
+[ -z "$(env 2>/dev/null | grep -iE '^https?_proxy=')" ] && say "  (未设代理)"
+if [ -r /etc/resolv.conf ]; then
+  say "DNS: $(grep -E '^nameserver' /etc/resolv.conf 2>/dev/null | awk '{print $2}' | tr '\n' ' ')"
+  NDOTS=$(grep -oE 'ndots:[0-9]+' /etc/resolv.conf 2>/dev/null)
+  [ -n "$NDOTS" ] && say "  options $NDOTS (K8s 内注意 ndots 坑, infra-k8s)"
+fi
+if have ip; then say "默认路由: $(ip route 2>/dev/null | grep '^default' | head -1)"
+elif have route; then say "默认路由: $(route -n 2>/dev/null | awk '$1=="0.0.0.0"{print $2; exit}')"; fi
+# 内网连通性探测(-H)
+if [ -n "$HOSTS" ]; then
+  say "内网连通性:"
+  OLDIFS=$IFS; IFS=','
+  for hp in $HOSTS; do
+    h=${hp%:*}; p=${hp##*:}
+    if have nc && nc -z -w 3 "$h" "$p" 2>/dev/null; then say "  $h:$p 通"
+    elif have python3 && python3 -c "import socket,sys;s=socket.socket();s.settimeout(3);sys.exit(0 if s.connect_ex(('$h',int('$p')))==0 else 1)" 2>/dev/null; then say "  $h:$p 通(python 探测)"
+    elif ( exec 3<>"/dev/tcp/$h/$p" ) 2>/dev/null; then say "  $h:$p 通(/dev/tcp)"; exec 3>&- 2>/dev/null
+    else say "  $h:$p 不通或无探测工具"; R="$R|$h:$p不通"; fi
+  done
+  IFS=$OLDIFS
+fi
+# 出网与带宽(-u,显式给了才测——离线环境不制造报错)
+if [ -n "$URL" ]; then
+  if have curl; then
+    SPEED=$(curl -o /dev/null -m 20 -s -w '%{speed_download}' "$URL" 2>/dev/null)
+    if [ -n "$SPEED" ] && [ "${SPEED%%.*}" -gt 0 ] 2>/dev/null; then
+      KBS=$(( ${SPEED%%.*} / 1024 ))
+      say "出网带宽实测($URL): 约 ${KBS} KB/s"
+      say "  换算: 100MB 传输约 $(( 102400 / (KBS>0?KBS:1) ))s —— 超时按载荷缩放(eng-complex-env 铁律)"
+      [ "$KBS" -lt 200 ] && Y="$Y|带宽仅${KBS}KB/s"
+    else say "出网: $URL 不可达(离线/白名单?)"; Y="$Y|出网不可达"; fi
+  else say "出网: 无 curl,跳过"; fi
+else
+  say "出网: 未指定 -u,跳过(离线环境这是常态,不算异常)"
+fi
+
+say ""
+say "---- [5/7] 资源与限制 ----"
+say "磁盘(标红>85%):"
+df -h 2>/dev/null | awk 'NR==1 || /^\/dev|overlay/' | while read -r line; do
+  pct=$(echo "$line" | awk '{gsub("%","",$5); print $5}')
+  case "$pct" in [0-9]*) [ "$pct" -gt 85 ] 2>/dev/null && line="$line   <== 高水位"; esac
+  say "  $line"
+done
+say "inode: $(df -i / 2>/dev/null | awk 'NR==2{print $5" 已用"}')"
+say "文件句柄上限(ulimit -n): $(ulimit -n 2>/dev/null)"
+U=$(ulimit -n 2>/dev/null); case "$U" in [0-9]*) [ "$U" -le 1024 ] 2>/dev/null && Y="$Y|句柄上限仅$U";; esac
+say "最大用户进程(ulimit -u): $(ulimit -u 2>/dev/null)"
+
+say ""
+say "---- [6/7] 时钟与安全上下文 ----"
+say "本机时间: $(date '+%F %T %Z')"
+if have chronyc; then say "NTP(chrony): $(chronyc tracking 2>/dev/null | grep -E 'System time|Leap' | tr '\n' ';')"
+elif have ntpq; then say "NTP(ntpq): $(ntpq -p 2>/dev/null | head -3 | tr '\n' ';')"
+elif have timedatectl; then say "NTP: $(timedatectl 2>/dev/null | grep -iE 'synchronized|NTP' | tr '\n' ';')"
+else say "NTP: 无对时工具可查 —— 内网务必确认对时方案(env-offline 内网 NTP)"; Y="$Y|对时不可查"; fi
+have getenforce && say "SELinux: $(getenforce 2>/dev/null)"
+[ "$(getenforce 2>/dev/null)" = "Enforcing" ] && Y="$Y|SELinux强制"
+have ufw && say "ufw: $(ufw status 2>/dev/null | head -1)"
+have firewall-cmd && say "firewalld: $(firewall-cmd --state 2>/dev/null)"
+
+say ""
+say "---- [7/7] 侦察结论 ----"
+[ -n "$R" ] && say "红灯: $(echo "$R" | sed 's/^|//;s/|/、/g')"
+[ -n "$Y" ] && say "黄灯: $(echo "$Y" | sed 's/^|//;s/|/、/g')"
+[ -z "$R$Y" ] && say "未见明显受限项(仍需人工确认: 变更窗口/审批链/数据出域规则——脚本测不出制度)"
+say "下一步: 本报告并入环境档案(eng-complex-env);方案评审时逐条对照'工具清单/带宽/权限'设计降级路径。"
+say "======================================================"
+[ -n "$OUT" ] && echo "(报告已落盘: $OUT)"
+exit 0

package/skills/eng-data-platform/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: eng-data-platform
+description: 数据工程链（数仓分层 ODS/DWD/DWS/ADS→维度建模与 SCD→批流选型判据→管道幂等与增量口径→调度 DAG 治理与基线告警→数据质量六维规则→血缘与下线流程→存储成本→数据服务化出仓）。工程链数据平台深耕:建数仓、写 ETL 管道、调度失败恢复、数据延迟或质量事故时载入。业务口径与指标体系走 data-chain/data-governance。
+version: 1.0.0
+---
+
+# 数据工程链
+
+engineering-chain 的数据平台子链。分工:本链管**生产数据的工程**(管道/建模/调度/质量工程/成本);
+业务口径、指标定义、分析方法走 **data-chain**(data-governance 裁决口径)。
+
+## 数仓分层
+
+| 层 | 职责 | 纪律 |
+|---|---|---|
+| ODS | 源系统原样落地 | 不清洗不改写;保留抽取时间/批次号审计字段;源系统 schema 变更在此隔离 |
+| DWD | 清洗后明细 | 一事实一表;清洗规则代码化可追溯;**业务逻辑从这层开始,不许在 ODS 上直接算报表** |
+| DWS | 轻度汇总宽表 | 面向复用的公共汇总(日粒度×核心维度);避免"一人一张宽表" |
+| ADS | 应用层 | 面向具体看板/接口;可牺牲范式换查询性能 |
+
+**跨层引用禁止**(ADS 直查 ODS=绕过清洗的裸数据进报表);同层横向引用要登记依赖(调度 DAG 依据)。
+
+## 维度建模
+
+- 星型优先(雪花只在维表过大时);事实表三类判据:事务型(一事件一行,默认)/周期快照(每日余额/库存)/累积快照(跟踪流程周期:下单→支付→发货各时点);
+- 缓慢变化维:SCD1 覆盖(不要历史)/SCD2 拉链(要历史,加生效起止+当前标记)——**"客户改名后历史报表按新名还是旧名"这类问题,建模期就要问业务**;
+- 一致性维度:全仓一份日期/组织/商品维,各业务域共用——维度不一致=跨域报表对不上的根源;
+- 代理键 vs 业务自然键:维表用代理键,业务键做唯一索引(业务键会变、会重用)。
+
+## 批流选型判据
+
+T+1 批处理=默认(成本最低、可重跑、好对账);分钟级新鲜度=微批;
+真流式(秒级)判据:**业务动作依赖实时结果**(风控拦截/实时推荐)才上——"老板想早点看到"通常微批就满足;
+Lambda 双跑(批流并行)的批流对账成本先认账再上;能用一套引擎批流一体就不养两套。
+真流式工程深耕(水位线/状态 TTL/反压/倾斜/savepoint/流批对账)载 **data-streaming**。
+
+## 管道工程纪律
+
+- **幂等**:重跑任意区间结果一致——分区覆盖写(INSERT OVERWRITE 分区)优于追加写;去重键明确;
+- 增量口径:水位字段(更新时间/自增 ID)+**迟到数据窗口**(回看 N 天重算,窗口大小写进表注释);
+- 分区裁剪:大表必分区(按日期),查询必带分区条件(全表扫描告警);
+- 小文件治理:落盘合并策略,小文件数进巡检指标(NameNode/元数据的隐形杀手);
+- 中间表落盘:复杂管道分段物化,失败从断点重跑而不是从头(与 data-report-pro 中间表纪律同拍)。
+
+## 调度治理
+
+- **DAG 依赖显式化**:上下游用依赖声明,禁止"错峰时间差,他应该跑完了"(隐式依赖=月初必炸);
+- 基线告警:核心产出表定 SLA(如"D+1 09:00 就绪"),基线预测破线提前告警,值班表跟上(eng-ops oncall 同构);
+- 补数流程:补数工具自动列出下游影响清单并级联重跑;**补数也是变更**(通知下游,留痕);
+- 失败处理:可重试的自动重试(幂等是前提),重试 3 次仍败才叫人;任务超时值=历史 P99×1.5,不设超时=僵尸任务。
+
+## 数据质量六维（规则挂表,工程化执行）
+
+完整性(行数波动/非空率)、唯一性(主键重复)、及时性(就绪时间 vs SLA)、一致性(跨表勾稽:明细汇总=总表)、
+准确性(与源系统抽样比对)、有效性(值域/格式)。
+规则纪律:新核心表上线**必带质量规则**(准入);规则失败分级(阻断下游 vs 告警放行,按表等级);
+**质量事故=线上事故**同级处置(eng-ops 流程):止血(拦截下游)→修复→补数→复盘回写规则——每次事故换一条规则,规则库就是免疫系统(与 data-chain 同拍)。
+
+## 血缘与元数据
+
+表级血缘自动解析(SQL 解析),字段级按需;每表四件套:注释/Owner/分层标记/保留策略;
+**下线流程**:血缘引用清零→公告期(2 周)→改名停写(反悔窗口)→删除;无主表季度认领,认不出的走下线;
+口径登记与指标字典对接 data-governance(工程侧保证"表是谁、从哪来",业务侧保证"数是什么意思")。
+
+## 存储与成本
+
+列存格式(Parquet/ORC)+压缩为默认;生命周期分层(热/温/冷/归档,按分区自动降级);
+成本分摊到团队(标签同 eng-infra FinOps);月度 TOP 表容量与访问热度交叉:大而冷的先治理(归档或降采样)。
+
+## 数据服务化(出仓三通道)
+
+API 服务(高频点查,加缓存与限流)/文件导出(批量,走审批)/反向 ETL(回写业务库,幂等与冲突策略先定);
+**出仓即脱敏审计**:按 data-governance 数据分级执行脱敏,出仓记录可追溯(谁、何时、取了什么)。
+
+**作业包**:`references/table-spec-template.md`(表规格卡(分层/SLA/增量口径/SCD)+质量规则六维表+管道与下线检查)。
+
+## 使用纪律
+
+schema 变更走 expand-contract(同 eng-database:先加后删,兼容下游两个周期);
+禁止无 Owner 的表上生产;每次数据事故三回写:质量规则+基线告警阈值+补数手册。
+**数据平台的信用=报表口径可复算+就绪时间可预期,两者都靠工程纪律不靠加班。**

package/skills/eng-data-platform/references/table-spec-template.md

@@ -0,0 +1,39 @@
+# 数据表规格与管道检查单（eng-data-platform 落笔件:新表/新管道上线用）
+
+## 1. 表规格卡(一表一卡,登记进元数据)
+
+| 项 | 内容 |
+|---|---|
+| 表名/分层 | __(ODS/DWD/DWS/ADS——跨层引用禁止) |
+| Owner/口径依据 | __ / 指标字典条目 __(data-governance) |
+| 主键/去重键 | __;事实表类型: □事务 □周期快照 □累积快照 |
+| 分区/生命周期 | 按 __ 分区;热 __ 温 __ 冷 __ 归档 __ |
+| 上游依赖 | 表:__(DAG 显式声明,禁时间差隐式依赖) |
+| SLA | D+__ __:__ 前就绪;基线告警已挂: □ |
+| 增量口径 | 水位字段 __;迟到窗口回看 __ 天(写进表注释) |
+| SCD 策略(维表) | □SCD1 覆盖 □SCD2 拉链——"改名后历史按新还是旧"业务确认:__ |
+
+## 2. 质量规则六维(新核心表必带,规则失败分级)
+
+| 维度 | 规则 | 阈值 | 失败动作(阻断/告警) |
+|---|---|---|---|
+| 完整性 | 行数环比波动 | ±__% | |
+| 唯一性 | 主键重复数 | =0 | 阻断 |
+| 及时性 | 就绪时间 vs SLA | | |
+| 一致性 | 与 __ 表勾稽:__ | 差异=0 | |
+| 准确性 | 与源抽样比对 __ 条 | | |
+| 有效性 | 值域/格式:__ | | |
+
+## 3. 管道上线检查
+
+- [ ] 幂等:重跑任意区间结果一致(分区覆盖写;INSERT OVERWRITE)
+- [ ] 断点续跑:分段落盘,失败从断点起
+- [ ] 分区裁剪:查询必带分区条件;小文件合并策略
+- [ ] 补数流程:下游影响清单可自动列出;补数=变更(通知+留痕)
+- [ ] 任务超时=历史 P99×1.5;重试幂等前提下自动重试 ≤3
+- [ ] 血缘已解析可查;(流作业另过 data-streaming 作业检查单)
+
+## 4. 下线流程(反向也要有单)
+
+- [ ] 血缘引用清零 → 公告期 2 周 → 改名停写(反悔窗口) → 删除
+- [ ] 无主表季度认领记录:__

package/skills/eng-database/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: eng-database
+description: 数据库链（存储选型判据(OLTP/KV/文档/时序/搜索/图/向量/OLAP)→schema 与主键设计→索引设计纪律→事务隔离与死锁三防→连接池公式→分库分表三板斧前置→expand-contract 变更迁移→高可用与容量水位）。工程链数据层深耕:建库建表、慢 SQL 治理、分表评估、数据库变更上线、连接池打满时载入。慢查询执行计划细则由 sql-tuning 承接。
+version: 1.0.0
+---
+
+# 数据库链
+
+engineering-chain 的数据层子链。总则:**先用默认(关系型),数据形态与实测证据出现后再分化**;
+生产库的每一条 DDL/DML 都是变更(eng-release/eng-ops 流程管辖)。
+
+## 存储选型判据表
+
+| 类型 | 启用信号 | 警示 |
+|---|---|---|
+| 关系型(默认) | 事务、关联查询、约束完整性 | 90% 的业务到最后还是它;引擎深耕载 **db-mysql**/**db-postgres** |
+| KV 缓存 | 热点读、会话、计数器 | 是加速层不是事实源;键设计/三防/分布式锁载 **db-redis** |
+| 文档型 | schema 多变、按聚合整读整写 | 跨文档事务与关联弱;"灵活"=约束债后置 |
+| 时序 | 写多改少、按时间窗聚合、要降采样 | 高基数标签会炸内存 |
+| 搜索引擎 | 分词、相关性排序、多维过滤 | 近实时非实时;不是事实源;专项(mapping/分片/ILM)载 **db-es** |
+| 图 | 多跳关系查询(3 跳以上) | 两跳以内关系型 JOIN 足够 |
+| 向量 | 语义检索/RAG | 召回≠精确,要配重排与兜底 |
+| OLAP 列存 | 大宽表聚合扫描、报表 | 点查与高频更新弱;与 OLTP 分开(HTAP 宣传打七折听) |
+
+多存储纪律:每多一种存储,备份/监控/值班/升级成本+1;**引入新存储=同时提交它的运维接管方案**(eng-infra/eng-ops)。
+
+## schema 设计
+
+- 三范式起步;反范式判据:读写比悬殊+JOIN 成本实测高+接受一致性维护成本(冗余字段要写清同步机制);
+- 字段纪律:能 NOT NULL 就 NOT NULL(NULL 是三值逻辑坑源);金额 DECIMAL 禁浮点;时间统一 UTC 存储+时区在展示层;枚举字段注释写全值域;预留字段是反模式(要加走变更);
+- 主键判据:单库自增够用;分布式用雪花/UUIDv7(**时间有序**,随机 UUIDv4 会把 B+ 树写碎);业务字段(手机号/身份证)禁做主键(会变、会重、有隐私);
+- 软删除的代价明说:唯一索引要带删除标记、所有查询要带过滤、数据只增不减——不是默认选项,按表评估。
+
+## 索引设计纪律
+
+- 最左前缀:联合索引列序=等值条件在前、范围在后、排序字段随后;
+- 选择性:区分度<10% 的列单独建索引基本无效(性别/状态);低区分度列放联合索引末位或不放;
+- 覆盖索引:高频查询让索引携带所需列,免回表;
+- **写放大警告**:每加一个索引,写入慢一分,索引数>6 的表先审老索引再加新的(无用索引月度清理,看使用统计);
+- **上线前 EXPLAIN 是纪律**:新查询/改查询必看执行计划(全表扫/文件排序/临时表三红灯),慢查治理走 sql-tuning。
+
+## 事务与隔离
+
+- 默认隔离级别行为差异要背:MySQL(可重复读,间隙锁)与 PG(读已提交)不同,跨库迁移必查;
+- **长事务危害清单**:锁持有放大、MVCC 版本膨胀、复制延迟——事务内禁止 RPC/HTTP 调用,>5s 事务告警;
+- 死锁三防:固定加锁顺序(按主键升序)、小事务、冲突高的操作改队列串行;死锁日志常开,出现即分析不积攒;
+- 幂等设计:唯一约束兜底 + 重试逻辑配合(网络超时后的重试是重复写入第一来源)。
+
+## 连接池
+
+- 参考公式:池大小 ≈ 核数×2 + 有效磁盘数——**不是越大越好**,几百个连接互相踩踏比排队更慢;
+- 超时三层齐配:获取连接超时、语句超时、事务超时(只配一层=其余两层裸奔);
+- 池满排查序:先查慢查询占坑(sql-tuning)再查池配置,扩池治标,慢查治本。
+
+## 分库分表(最后的手段)
+
+- **三板斧用尽再谈**:索引与 SQL 优化 → 读写分离(注意复制延迟的读己之写问题) → 归档冷热分离(历史数据挪走,常客是它);
+- 量级参考:单表 5000 万行/10GB 只是"开始评估"的信号,不是"必须拆"的红线——以实测性能为准;
+- 分片键判据:最高频查询维度(用户系统用 userId);跨片查询与热点(大客户单片过热)先想好;
+- 拆分代价清单(评审必读):全局唯一 ID、跨片事务(最终一致+对账)、跨片 JOIN(反范式或异构索引)、扩容再平衡、运维复杂度全面上升。
+
+## 变更迁移（expand-contract）
+
+五步:**加**新结构(兼容旧代码)→**双写**→**回填**(分批限流+校验脚本)→**切读**→**收缩**(下一版本才删旧结构);
+配套纪律:变更脚本可重入(重跑不炸)+回滚脚本配对提交;大表 DDL 用 online 方案(锁表评估写进变更单);
+**发布协同红线见 eng-release:代码可回滚的前提是 schema 兼容上一版**。生产库禁止裸 DML:走工单+复核+前置快照(eng-ops 四眼原则)。
+换库/搬迁/分表数据搬运(六步法/三层校验/异构坑清单)载 **db-migration**。
+
+## 高可用与容量
+
+主从延迟持续监控(读写分离的读一致性依据);故障切换季度演练(自动切换也要演,脑裂预案要有);
+备份恢复见 eng-ops 3-2-1 与演练纪律;容量水位:磁盘 70% 扩容立项、连接数/QPS 峰值月报(eng-ops 水位报告)。
+
+**作业包**:`references/schema-review-checklist.md`(新表四件套/字段与索引纪律勾选/DDL 上线检查(算法确认+清长事务+演练计时)/慢查登记行)。
+
+## 使用纪律
+
+ORM 生成的 SQL 抽查 EXPLAIN(ORM 不是免检金牌);新表上线四件套:注释齐全/索引评审/归档策略/Owner;
+每次慢查/死锁/容量事故回写模式库。**数据库的债最贵:代码可以重写,数据错了是真丢。**

package/skills/eng-database/references/schema-review-checklist.md

@@ -0,0 +1,37 @@
+# 建表与变更评审单（eng-database 落笔件:新表/加索引/DDL 上线逐项勾）
+
+## 1. 新表四件套
+
+- [ ] 表与字段注释齐全(枚举写全值域);Owner:__
+- [ ] 归档策略:保留 __;冷数据去向 __(建表时就想,别等 5000 万行)
+- [ ] 索引评审(见下)  - [ ] 预估容量:日增 __ 行×__B(capacity-calc storage 算过)
+
+## 2. 字段纪律速查
+
+- [ ] 能 NOT NULL 则 NOT NULL;金额 DECIMAL 禁浮点;时间 UTC 存储
+- [ ] 主键:自增/雪花/UUIDv7(时间有序);业务字段不做主键
+- [ ] 软删除?→ 唯一索引带删除标记+全查询带过滤的代价已认
+- [ ] 无预留字段(要加走变更);字符集 utf8mb4 统一
+
+## 3. 索引评审
+
+- [ ] 联合索引列序:等值在前范围在后;最左前缀可复用
+- [ ] 选择性:区分度<10% 的列不单独建
+- [ ] 该表索引总数 __(>6 先审老索引再加新)
+- [ ] 高频查询覆盖索引评估;**每条新查询 EXPLAIN 过**(全表扫/文件排序/临时表三红灯)
+
+## 4. DDL 上线检查(变更窗口执行)
+
+- [ ] 算法确认:INSTANT/INPLACE/COPY(db-mysql 三算法)或 CONCURRENTLY(db-postgres)
+- [ ] 执行前清长事务(metadata lock 连环塞预防;mysql-health.sql 第 1/3 节先跑)
+- [ ] 大表:测试库同量级演练计时 __ 分钟;磁盘余量 ≥ 表大小×2
+- [ ] 亿级表:gh-ost/pt-osc 方案;限速与暂停点
+- [ ] 变更脚本可重入+回滚脚本配对提交(expand-contract:本次是"加"还是"收缩"阶段?)
+- [ ] schema 兼容上一版代码(eng-release 回滚红线)
+
+## 5. 慢查治理登记行(周报用)
+
+| SQL 指纹 | 来源模块 | 平均ms | 扫描行 | 病因(无索引/隐式转换/N+1/深分页) | 处置 | Owner |
+|---|---|---|---|---|---|---|
+
+> ORM 生成的 SQL 也抽查 EXPLAIN;生产库禁裸 DML(工单+复核+快照)。

package/skills/eng-develop/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: eng-develop
+description: 开发子链总控（领任务→分支→编码→自测→自评→提交 PR 全流程、语言无关编码规范通则、DoD 完成定义、AI 结对纪律;按技术栈路由 13 条孙链:通用工具链/Java/Python/C#/前端/Node/Go/Rust/C++/移动端/跨端/鸿蒙/PHP）。工程链开发环节入口:动手写码前、跨语言协作、不确定用哪条语言链时载入。
+version: 1.0.0
+---
+
+# 开发子链总控
+
+engineering-chain 的开发环节子链,也是 12 条语言/工具孙链的路由入口。
+输入:验收标准(eng-requirements)+方案与落点(eng-architecture);产出:可评审的 PR。
+
+## 语言/工具孙链路由表
+
+| 技术栈 | 孙链 | 一句定位 |
+|---|---|---|
+| 语言无关工具底座 | **dev-toolchain** | Git 进阶/调试方法论/构建缓存/私服镜像/pre-commit/AI 结对 |
+| Java | **dev-java** | JDK 版本策略/Spring 事务八坑/线程池公式/JVM 与 arthas |
+| Python | **dev-python** | uv 环境/类型渐进/pytest/asyncio 判据/pandas 内存 |
+| C#/.NET | **dev-csharp** | .NET LTS/DI 生命周期/EF Core 三宝/async 全链/AOT |
+| 前端(JS/TS) | **dev-frontend** | Vite 工程化/状态分层判据/Core Web Vitals/请求层规范 |
+| Node 服务端 | **dev-node** | 事件循环阻塞/流与背压/优雅退出/容器内存对齐 |
+| Go | **dev-go** | 错误包装惯例/context 纪律/goroutine 泄漏防治/pprof |
+| Rust | **dev-rust** | 所有权心智/thiserror-anyhow 分工/tokio 要点/unsafe 纪律 |
+| C/C++ | **dev-cpp** | 现代 CMake/RAII 所有权/UB 清单/sanitizers 全家桶 |
+| 移动端原生 | **dev-mobile** | 双端 MVVM/启动与包体积/隐私合规/灰度热修判据 |
+| 跨端/小程序 | **dev-cross-platform** | Flutter/RN/uni-app/Electron 判据表/小程序专项 |
+| 鸿蒙 | **dev-harmony** | ArkTS 约束与迁移/Stage 与包结构/一多真伪需求/三端并存策略 |
+| PHP | **dev-php** | PHP8 现代化/FPM 调参/安全 TOP/Swoole 常驻心智 |
+| AI/LLM 应用 | **eng-ai** 域 | LLM 接入/RAG/Agent/提示/评测/服务运维（ai-* 六孙链入口） |
+
+路由纪律:语言特定问题(依赖治理/性能画像/框架坑)直载对应孙链;多语言项目按当前要动的代码路由;
+新项目选语言=选型决策,走 **eng-research** 评分卡而不是凭偏好。
+
+## 开发全流程（领任务 → PR 合入）
+
+1. **领任务核对**:验收标准读一遍,判不了 PASS/FAIL 的先打回 eng-requirements;
+2. **摸落点**:existing 代码先 explain-codebase(调用链/数据流/惯例),**看不懂的代码不改**;
+3. **分支**:从主干拉 `feature|fix|hotfix/工单号-简述`,寿命目标 <3 天(eng-release 分支策略);
+4. **测试先行**:关键逻辑先写失败用例再实现(write-tests);
+5. **小步提交**:每提交一个意图、可构建可测试、可独立回滚;禁攒一周一把梭;
+6. **自测**:跑本地全量相关测试+手工过一遍验收标准主路径;
+7. **自评 diff**:提 PR 前自己逐行 review 一遍(捞掉调试残留/误改/console),**自评能拦一半评审意见**;
+8. **提交**:commit-and-pr 规范(消息说 why 不复述 diff);PR 描述贴验收标准勾选情况。
+
+## 编码规范通则（语言无关,语言细则见孙链）
+
+- **命名**:意图优先、可搜索(全局搜 `tmpFlag` 应唯一命中);布尔名回答问题(isXxx/hasXxx);反例:data2、doProcess、flag。
+- **函数**:单一职责;参考值 ≤40 行、参数 ≤4 个,超了先怀疑职责混杂;圈复杂度高的先拆再改。
+- **错误处理**:不吞异常(空 catch=定时炸弹);失败早暴露(fail fast);错误信息三要素:在做什么/输入是什么/期望是什么;每个错误只在一处记日志(层层重复打=日志洪水)。
+- **日志**:结构化、分级准确(见 eng-observability 分级纪律)、禁敏感信息(密码/证件/手机号);关键业务动作 INFO 留痕。
+- **注释**:只写"为什么"(权衡/约束/陷阱),不写"是什么"(代码自己会说);过期注释比没注释毒。
+- **常量**:魔法数字与字符串入常量并命名其含义;配置与代码分离(可变的进配置)。
+- **TODO**:必须挂工单号+人名,裸 TODO 门禁拦截(dev-toolchain pre-commit)。
+- **复用优先**:写新代码前先搜仓库同类实现;重复第三次才抽象(过早抽象比重复更难拆)。
+
+## DoD 完成定义（说"做完了"之前逐项勾）
+
+功能过全部验收标准 / 新逻辑有单测且全绿 / 静态检查零新增告警 / 涉接口更新契约文档(api-design) /
+涉配置与部署更新说明 / 无调试残留(打印/断点/临时开关/注释掉的代码) / 埋点按需求就位 / 自评过。
+
+## AI 结对纪律
+
+- 上下文喂足再要产出:相关文件、项目惯例、约束条件——垃圾进垃圾出;
+- **AI 产出逐行读懂才许提交**,读不懂=不是你的代码,出了事故你背不动;
+- 测试先行让 AI 补实现,比让 AI 连测试一起编更可靠(自产自测=既当运动员又当裁判);
+- 边界条件亲自过一遍(空/极值/并发/权限),AI 的盲区高度集中在这里;
+- 密钥、内部数据、未公开代码不出内网喂外部模型(eng-security);
+- 深耕(任务适配判据表/上下文工程/代理模式任务书/提效度量)载 **ai-coding**。
+
+**作业包**:`references/dod-checklist.md`(DoD 逐项勾/PR 描述模板/自评九查(空值边界并发越权事务超时幂等))。
+
+## 使用纪律
+
+红灯(构建/测试失败)期间不合入新功能;每个 PR 讲得出"为什么这么改"而不只是"改了什么";
+遇到设计层面的疑问回 eng-architecture 而不是"先绕过去";写码中发现的债记台账不顺手大改
+(**一个 PR 只干一件事**——重构与功能分开提)。

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

@@ -0,0 +1,43 @@
+# 开发完成定义与自评单（eng-develop 落笔件:提 PR 前逐项勾）
+
+## DoD 完成定义(说"做完了"之前)
+
+- [ ] 功能过全部验收标准(对着 story-templates 的 Gherkin 逐条勾)
+- [ ] 新逻辑有单测且全绿;关键路径先写失败用例再实现
+- [ ] 静态检查零新增告警;格式化通过(工具管,评审不吵空格)
+- [ ] 涉接口:契约文档已更新(api-design 同源)
+- [ ] 涉配置/部署:变更说明已写(部署说明进 PR 描述)
+- [ ] 埋点按需求就位;日志分级正确且无敏感信息
+- [ ] 无调试残留:print/console/断点/临时开关/注释掉的代码
+- [ ] 自评过:自己逐行 review 一遍 diff(能拦一半评审意见)
+
+## PR 描述模板
+
+```
+## 为什么(Why)
+<业务/技术动因,关联需求 REQ-__ 或工单 __>
+
+## 改了什么(What)
+<一句话概述;大改动列模块清单>
+
+## 怎么验证(How verified)
+<验收标准勾选情况 / 测试证据 / 复现步骤>
+
+## 风险与回滚
+<影响面;能否一键回滚;涉 schema 是否兼容上一版(eng-release 红线)>
+
+## AI 参与度
+<无/补全/对话/代理生成,重点抽查区提示(ai-coding 评审适配)>
+```
+
+## 自评九查(高频翻车点速扫)
+
+- [ ] 空值/空集合路径  - [ ] 边界(0/1/最大/超长)  - [ ] 重复提交与并发双击
+- [ ] 权限:水平越权(资源属主)+垂直越权(角色)——前端隐藏≠控制
+- [ ] 事务边界:该原子的原子了;事务内无 RPC/HTTP(db 链)
+- [ ] 超时:每个外部调用有超时(eng-reliability 判据表)
+- [ ] 错误信息三要素:做什么/输入啥/期望啥;不吞异常
+- [ ] 幂等:写接口重试安全(arch-distributed 四模式)
+- [ ] 大数据量:列表有分页;循环内无 IO/查询(N+1)
+
+> 一 PR 一意图;>400 行拆分(eng-collaboration);看不懂的代码不改(先 explain-codebase)。

package/skills/eng-docs/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: eng-docs
+description: 技术文档与知识链（Diátaxis 四象限文档类型判据→docs-as-code 同仓同评审→关键文档清单(README 六要素/Runbook 结构/API 文档同源)→图 as code→文档腐化治理与保鲜期→新人上手路径验收→知识回写闭环汇总→文档度量）。工程链文档深耕:建文档体系、README/Runbook 缺失混乱、新人上手慢、知识都在老员工脑子里时载入。办公 SOP 与知识库运营走 knowledge-sop。
+version: 1.0.0
+---
+
+# 技术文档与知识链
+
+engineering-chain 的文档子链。分工:本链管**工程文档**(代码库伴生的知识),办公 SOP 与通用知识库运营走 knowledge-sop;
+第一原则:**文档是给三个月后的自己和下一个接手的人写的**——写不写的判据是"没有它,别人要走多少弯路"。
+
+## 文档类型判据（Diátaxis 四象限,别把四种写成一坨）
+
+| 类型 | 回答 | 写法要点 | 反例 |
+|---|---|---|---|
+| 教程 Tutorial | 带我入门 | 保姆级步骤,从零到跑通,每步有预期输出 | 中途冒出三个"高级选项"岔路 |
+| 操作指南 How-to | 怎么完成某任务 | 目标导向,前置条件明确,可复制命令 | 混入原理长篇(读者在救火) |
+| 参考 Reference | 精确查询 | 结构化全量(API/配置项/错误码),从代码生成优先 | 手维护参考=注定过期 |
+| 解释 Explanation | 为什么这样设计 | 背景权衡取舍(ADR 是其一种,eng-architecture) | 写成操作步骤 |
+
+写前先问读者带着哪类问题来——同一主题四类可各有一篇,揉成一篇=四类读者都骂。
+
+## docs-as-code 纪律
+
+文档与代码**同仓、同 PR、同评审**:改行为不改文档=PR 不完整(DoD 项,eng-develop);
+Markdown 为体,渲染为用;图 as code(mermaid:架构图/时序图/状态机),**截图类图三月必过期,代码生成的图跟着改**;
+参考类文档从源生成:API 文档从契约(api-design)、配置说明从配置 schema、错误码表从枚举——**单一事实源,手抄必漂移**;
+文档也有目录设计(信息架构,eng-ux 同法):按读者任务组织,不按团队组织架构组织。
+
+## 关键文档清单（每个仓库/服务的标配）
+
+- **README 六要素**:这是什么(一句话+边界)/怎么跑起来(本地 quickstart,验收标准=新人半天跑通,dev-toolchain)/怎么测试/怎么部署发布/目录结构导读/求助渠道(Owner+群);
+- **Runbook**(每个告警/预案配一篇,eng-observability 告警三问的"知道怎么动手"落点):结构=症状→影响评估→诊断步骤(带命令)→处置动作(带回滚)→升级路径——**验收标准:新值班照着能独立处置**,恐慌时刻没人读散文;
+- ADR(eng-architecture)/接口契约(api-design)/集成档案(eng-integration)/部署与配置说明(eng-release)/数据字典(data-governance)——各链产物,本链管"有没有、放哪、活没活着";
+- 新人上手路径:第一天(环境+跑通)/第一周(架构导读+首个小任务)/首月(值班跟班)——**上手时长是文档体系的终极验收指标**(eng-efficiency 采样)。
+
+## 文档腐化治理（文档最大的问题不是没有,是不可信）
+
+每篇关键文档三件套:Owner/最后验证日期/**保鲜期**(教程与 Runbook 90 天,参考类跟代码生成,解释类一年);
+到期例程提醒复核(eng-automation),复核=按文档真跑一遍不是扫一眼;
+过期未复核自动标注"⚠ 可能过时"——**错误的文档比没有文档更危险**(读者按它操作会出事故);
+文档 bug 同缺陷流程(eng-quality):发现错了就提单,顺手能修就修(改文档的 PR 免评审门槛可放宽);
+废弃纪律:下线的功能文档归档不删除(留考古线索),入口移除。
+
+## 知识回写闭环（工程链复利的总账房）
+
+各链的"回写"落点在这里汇总成体系:
+复盘→根因模式库(eng-ops)/坑清单(各 dev-* 链)/估时校准库(eng-planning)/调研报告与雷达(eng-research)/
+ADR 后果回填(eng-architecture)/评测坏例集(ai-eval)——
+**回写三纪律**:当场写(过周即忘)/写在别人找得到的地方(挂对应链的台账不是个人笔记)/下次真的先查(会前查库是流程步骤不是美德);
+高频被问的问题=文档缺口信号(答三遍就写下来,答案链接化——"看这篇"比重复口述省十倍)。
+
+## 协作与评审
+
+文档评审看三点:读者对不对(类型判据)/新人视角能不能跑通(找个没上下文的人试读)/与代码一致否;
+术语表全仓统一(同物同名,新词入表);
+会议纪要与决策记录:决策+理由+行动项三要素落文档(meeting-minutes 承接),**口头决策=没有决策**。
+
+## 度量（轻量,别为度量而度量）
+
+新人上手时长(每位新人记录,趋势看体系);文档命中率(被搜到且解决问题的比例,搜索日志高频无结果词=缺口清单,eng-ux 同法);
+Runbook 覆盖率(P1P2 告警配 Runbook 的比例,目标 100%);保鲜达标率(未过期占比);
+**不度量字数与篇数**(文档以少而准为荣,eng-efficiency 反模式同理)。
+
+**作业包**:`references/runbook-template.md`(Runbook 模板(症状→诊断→处置→升级,新值班能独立执行)+README 六要素+保鲜头部)。
+
+## 使用纪律
+
+改行为必改文档(DoD);关键文档有 Owner 有保鲜期;参考类一律代码生成;
+每次"问了三遍的问题"沉淀成文;每次因文档过期导致的事故,保鲜期减半重核——
+**文档体系的验收不是"写了多少",是"新人多快独立、值班多稳、老知识多可信"**。

package/skills/eng-docs/references/runbook-template.md

@@ -0,0 +1,57 @@
+# Runbook 与 README 模板（eng-docs 落笔件）
+
+## 1. Runbook 模板(一告警/预案一篇;验收=新值班照着能独立处置)
+
+```markdown
+# RB-__: <告警名/场景名>
+> Owner: __ | 最后验证: __(保鲜期 90 天,到期真跑一遍不是扫一眼) | 关联告警: __
+
+## 症状
+<值班看到什么:告警文案/大盘形态/用户表现>
+
+## 影响评估(30 秒判级)
+<影响谁/多大面 → P 级判定(eng-ops 分级看影响不看原因)>
+
+## 诊断步骤(带命令,恐慌时刻没人读散文)
+1. <命令/看哪个盘> → 若 __ 则 __
+2. <一键体检: quick-triage.sh / k8s-triage.sh / 对应 db 巡检>
+3. <变更嫌疑: 查变更日历最近 __ 小时>
+
+## 处置动作(带回滚)
+- 止血: <四板斧哪一斧,预案开关编号>
+- 若无效: <下一招>
+- 回滚方式: <怎么退回来>
+
+## 升级路径
+<15min 无进展 → __;30min → __;P1 立即 __>
+```
+
+## 2. README 六要素骨架
+
+```markdown
+# <项目名>
+<一句话:这是什么+边界(不做什么)>
+
+## 快速开始   <!-- 验收:新人半天跑通 -->
+<环境要求(版本锁定文件指路) / 三条命令: make setup / make test / make run>
+
+## 测试与质量
+<怎么跑测试/门禁有哪些>
+
+## 部署与发布
+<怎么发/发布单模板指路/回滚方式>
+
+## 目录导读
+<关键目录一行一句>
+
+## 求助
+<Owner/群/FAQ 链接;文档缺口提这里>
+```
+
+## 3. 文档保鲜头部(关键文档统一加)
+
+```markdown
+> Owner: __ | 类型: 教程|操作|参考|解释 | 最后验证: YYYY-MM-DD | 保鲜期: 90天|跟代码|1年
+```
+
+> 参考类从代码生成不手抄;改行为必改文档(DoD);高频被问三遍的问题→沉淀成文答链接。