风险与卡点¶
当前已知的风险、阻塞项、技术债。
当前风险¶
PR #5 合入时 reviewer 未全部 accept（IK37HX 修复链路）
事项：PR #5 — fix(sql-dis-opt): IK37HX 修复 skill 缺陷
阻塞点：reviewer buaazyp（张英鹏）assignee/tester 均 accept=false，仅 wanjiayin accept；PR 已于 2026-07-28 合入 develop。
影响：IK37HX 缺陷修复未走完整双 reviewer 流程，4 处 skill 缺陷（环境初始化 / 分片键来源 / execute.py 参数 / 大表超时降级）的回归证据需在 issue 中补齐后再关闭。
建议动作：在 27 服务器上跑 gcsdb_0005 / gcsdb_0019 回归，把执行证据贴到 IK37HX 评论，由张英鹏复核后关闭 issue。
PR #3 / PR #4 合入时 reviewer 未全部 accept（IK1CK3 规则验证通路）
阻塞点：两个 PR 的 reviewer buaazyp 均 accept=false，仅 wanjiayin accept；均已合入。
影响：IK1CK3-PR2 / IK1CK3-PR4 在依赖合入后即可启动，但 reviewer 未签字意味着 rule-match skill 设计选型（外挂规则库检索 / 命中判定口径）未经过双人复核。
建议动作：在 IK1CK3-PR4 端到端验证阶段，请张英鹏补一轮设计复盘，确认 P-003 / P-008 / P-012 三条规则报告可信。
IK37HX 服务器部署暴露路径漂移问题（PR !5 合入后）
问题：
- P-1.5：env_check.py venv 路径硬编码 scripts/venv/ + Python 3.10，未读 SQL_OPT_VENV，导致几乎所有真实服务器部署（venv 在项目根 / 部署根）都被误判环境不可用
- P-2.5：pending_rules_1.md 物理位置已从仓库根移至 skills/rule-match/，但 12 处文档（rule-match/SKILL.md / sql-distributed/SKILL.md / .opencode/ 镜像）仍写「仓库根」，agent 按文档找不到规则库
当前进展：跟进补丁 commit 8aab330（2026-07-29 合 develop）已收紧 env_check 契约（不扫本地 venv、不依赖 activate）并将 pending_rules_1.md 迁至 skills/rule-match/rules/ 同步全部引用方。
未消解风险：路径稳定性的根因未解——「未来 pending_rules_2 / approved_rules 进来还会再变」。建议后续 issue 把规则库目录作为契约固定。
技术债¶
| 债务 | 引入时间 | 影响 | 计划 |
|---|---|---|---|
| 代理脚本硬编码 primary/fallback 模型 | IJZKZE 实现期（PR #2 已合入） | 改模型需改代码 | 后续 issue 做配置化 |
rule-validate → rule-match rename 已落 commit，但 IK1CK3 tech-spec / 部分文档仍引用旧名 |
2026-07-20（commit 589b64b） | 新人理解成本、检索断裂 | IK1CK3-PR4 阶段统一文档命名 |
| sql-distributed 步骤 3 环境初始化对内网/损坏 venv 无 fallback 指引 | IK37HX P-1，PR #5 + 8aab330 已修复 |
离线环境执行卡顿 | 验证回归后随 issue 关闭消解 |
分片键推断值未强制暴露 source 字段给下游 |
IK37HX P-2，PR #5 已修复 | 推断值被当确认值用，索引建议可能误导向 | 同上 |
execute.py 空索引场景下省略 --index-ddl / --rollback-index |
IK37HX P-3，PR #5 已修复 | 审计字段空值，无法判定是否漏走索引路径 | 同上 |
| baseline.py 大表超时无降级路径 | IK37HX P-4，PR #5 已修复（>300s 直接报超时走人工） | 大表 case 在第一步被拦死 | 同上 |
env_check.py venv 路径硬编码（scripts/venv + Python 3.10，未读 SQL_OPT_VENV） |
IK37HX 服务器部署反馈（2026-07-28） | 真实服务器部署整 case 误走「模型优化-未验证」 | 8aab330 已收紧契约，待回归 |
pending_rules_1.md 物理位置已迁移但 12 处文档引用未同步 |
PR #5 重组副作用 | agent 按文档找不到规则库，rule-match 步骤失败 | 8aab330 已统一迁至 skills/rule-match/rules/ 并同步引用方 |
| 规则库目录路径不稳定（根 → skills/rule-match/ → skills/rule-match/rules/，已变 2 次） | PR #5 + 8aab330 累积 |
未来 pending_rules_2 / approved_rules 进来还会再变；所有引用方都要逐一改 |
建议后续 issue 把规则库目录作为契约固定 |