---
name: mid-shared
description: "[internal] Shared reference files for the mid workflow (mid-plan / mid-detail-plan). Not invoked directly — sibling mid-* skills resolve paths via ../mid-shared/references/{file}.md. Kept hidden from model invocation."
disable-model-invocation: true
---

# mid-shared（共享参考，不可主动调用）

> **这是一个物理载体 skill，不是可执行工作流。** 不要主动加载、不要 `/skill:mid-shared`。
> 它存在的唯一目的：让 `references/` 目录被 pi 安装（symlink 到 `~/.pi/agent/skills/mid-shared/`），
> 从而使兄弟 skill 通过相对路径 `../mid-shared/references/{file}.md` 能稳定命中本目录文件。
>
> `disable-model-invocation: true` 使本 skill **不进入** system prompt 的 `<available_skills>` 列表——
> AI 无法主动发现或调用它。但 pi 的发现管道仍会加载它（symlink 安装 + 进 resourceLoader），
> 其 `references/` 子目录随目录级 symlink 天然可达。

## 定位

mid-* 是 full-* 的**编排变体**：内容对齐 full 全量（6 份 deliverable + 机器检查 + 红队门），编排改为
lite 风格（draft → batch-ask → review-fix-loop）。服务 full 复杂度档位里的 **L2 标准档**——比 full 的
每阶段深度收敛快，比 lite 的无架构设计重。

| 维度 | full-*（重） | **mid-*（中）** | lite-*（轻） |
|------|---------------|-------------|-------------|
| 适用场景 | L3 重型（多系统/跨组织/状态机复杂） | **L2 标准（多模块单系统/3~5 Wave）** | L1 小功能（无架构改动） |
| 内容 | 6 份 deliverable | **6 份 deliverable（同 full）** | plan.md 单文件 |
| 编排 | 每阶段 6 步循环（追踪+审查分两道） | **draft + batch-ask + review-fix-loop** | plan + execute + retrospect |
| ask_user | 逐个 Grilling（40~80 次） | **批量（3~5 次）** | 1~3 次 |
| subagent | 30~48 | **~20** | 5~10 |
| 阶段数 | 6+1 | **2**（mid-plan + mid-detail-plan） | 1 |

**mid 的核心取舍：** 用「正交认知帧 + 跨阶段合并」换 wall-clock。合并追踪+审查损失了 full 两道隔离的 bias 防护，
靠禁读重建路 + 红队路反向帧对冲。详见 `references/review-fix-loop.md`「为什么是它」。

## 文件清单

| 文件 | 作用 | 何时读 |
|------|------|--------|
| `references/review-fix-loop.md` | mid 核心循环协议（6 步：机器检查→派 N 路 reviewer→认知帧→汇总去重→收敛→修复/超限）+ 派发模板 + 汇总规则 + 与 full 6 步循环差异 | 每个 skill 进入 review-fix-loop 阶段前 read |
| `references/batch-ask.md` | 批量提问协议（收集→分类→批量 ask_user→纳入 decisions.md）+ 二次 ask + 单问例外 | 每个 skill 进入 batch-ask 阶段前 read |

## 引用约定（重要）

兄弟 skill（mid-plan / mid-detail-plan）引用本目录文件，**必须用 `../mid-shared/references/{file}.md`** ——
相对路径的解析基准是当前 skill 的 baseDir（SKILL.md 的 dirname），`../` 跨到兄弟目录 `mid-shared/`。

不要用裸路径 `mid-shared/references/...`：那会解析成 `{当前skill}/mid-shared/...`，安装态下 broken。

## 跨目录引用（复用 full 资产）

mid 不重写 full 的内容资产，**全部复用**。跨到 full 目录的引用：

- **机制类**（跨阶段协议）：`../full-shared/references/{loop-skeleton|loop-method|review-agent|context-builder}.md`
  - `loop-skeleton.md` 的「subagent 派发工程规范」「decisions.md 机制」「标记约定速查表」mid 全部沿用
  - `review-agent.md` 的 6 维审查 spec + 红队维度，mid 的 reviewer 路直接引用
  - `context-builder.md` 的阶段工作摘要，mid-detail-plan Step 0 派发时引用
- **阶段内容类**（deliverable 模板 + 视角 + 词汇表）：`../full-{clarity|architecture|issues|nfr|code-arch|execution-plan}/references/*.md`
  - mid-plan 复用 `full-clarity` + `full-architecture` 的全部 references
  - mid-detail-plan 复用 `full-issues` + `full-nfr` + `full-code-arch` + `full-execution-plan` 的全部 references
- **机器检查**：由 CW gate 在 `cw(action=clarify/detail)` 调用时自动执行（TS check 函数，不再是 python 脚本）。mid 不手动跑 check 脚本——调 CW 即触发。
- **渲染 HTML**：`coding-visualizer` skill（mid 定稿后派 fresh subagent 加载它渲染）

> mid-shared 只承载 **mid 独有的编排抽象**（review-fix-loop + batch-ask）。其余机制（派发工程、decisions.md、
> context-builder、review 维度 spec、deliverable 模板、机器检查、HTML 渲染）全部引用 full 资产或 CW gate，不重复实现。