메뉴
[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.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
完成 worktree 的完整合并流程：本地验证 → PR CI → merge → post-merge CI → 发布准备 → Release Notes → 创建 Release → 清理。 使用 git merge --no-ff 保留完整分支历史。 支持项目级钩子（.bare/custom-hooks/）实现个性化发布流程。 触发词："合并worktree"、"merge-worktree"、"合并PR"、"发布"、"release"、"上线"。
Reference for writing workflow JS scripts. Auto-loaded when using workflow-generate or writing/editing workflow scripts for Pi. Covers runtime environment, injected globals, constraints, and script patterns. Not for general coding or subagent usage.
Use when the user says "轻量执行", "lite execute", "按 Wave 执行", "goal 模式执行 plan", "执行 plan", or has a completed plan.md (from lite-plan) or execution-plan.md (from mid-detail-plan) and needs to execute the Waves. ADR-029 后阶段 A+B 由 workflow run execute-full-workflow 机器接管（worktree-setup → dev waves → test+review → cleanup），主 agent 不再直接派 subagent。 对应 CW action: dev (workflow 内 implementer 渐进式提交) + test (workflow 内 test-runner 渐进式提交). Not for planning (lite-plan / mid-detail-plan). Not for retrospect (coding-retrospect).
Use when the user says "issue拆分", "问题分解", "issue decomposition", "方案对比", "tradeoff analysis", "优先级排序", or has finished system-architecture.md and needs to break it into prioritized issues with solution comparisons. Produces issues.md as a fog-of-war decision map. Step 3 of 6. Not for business requirements (Step 1) or architecture modeling (Step 2). Not for non-functional risk analysis (Step 4) or code-level design (Step 5).
Use when the user says "mid 详细计划", "中等功能实施设计", "issues+nfr+架构+计划一起做", "批量设计实施", or has finished mid-plan and needs issues.md + non-functional-design.md + code-architecture.md + execution-plan.md (+ code-skeleton) + detail.json (CW detail action 入参). 纯设计 skill，不写实现代码。对应 CW action: detail. Not for L3 heavy (use full-*). Not for requirements/architecture (that is mid-plan).
[internal] Shared reference files for the lite workflow (lite-plan / coding-execute / coding-retrospect). Not invoked directly — sibling lite-* skills resolve paths via ../lite-shared/references/{file}.md. Kept hidden from model invocation.
| 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 |
这是一个物理载体 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。
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 派发时引用../full-{clarity|architecture|issues|nfr|code-arch|execution-plan}/references/*.md
full-clarity + full-architecture 的全部 referencesfull-issues + full-nfr + full-code-arch + full-execution-plan 的全部 referencescw(action=clarify/detail) 调用时自动执行（TS check 函数，不再是 python 脚本）。mid 不手动跑 check 脚本——调 CW 即触发。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，不重复实现。