菜单
[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.
用 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 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.
| name | lite-shared |
| description | [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. |
| disable-model-invocation | true |
这是一个物理载体 skill，不是可执行工作流。 不要主动加载、不要
/skill:lite-shared。 它存在的唯一目的：让references/目录被 pi 安装（symlink 到~/.pi/agent/skills/lite-shared/）， 从而使兄弟 skill 通过相对路径../lite-shared/references/{file}.md能稳定命中本目录文件。
disable-model-invocation: true使本 skill 不进入 system prompt 的 available skills 列表—— AI 无法主动发现或调用它。但 pi 的发现管道仍会加载它（symlink 安装 + 进 resourceLoader）， 其references/子目录随目录级 symlink 天然可达。
lite-* 是 full-* 的轻量化对照：full 服务"涉及架构决策的复杂需求"（L2/L3，6 步设计循环 + fresh-subagent 审查 + 反哺 + 一致性终检）；lite 服务"不涉及架构改动的小功能开发"（L1，plan + goal + todo + subagent 直连，强制严格测试）。
| 维度 | full-*（重） | lite-*（轻） |
|---|---|---|
| 适用场景 | 跨子系统/状态机变更/架构决策 | 小功能、单/少模块改动 |
| 设计流程 | 6 步循环 + 追踪 + 审查门 + 反哺 + 终检 | plan.md 单文件（业务目标 + 技术改动点 + Wave + 测试清单） |
| 测试 | test-matrix 重建（⑤） | 强制单测覆盖率≥60% gate + E2E 边界覆盖 |
| 执行编排 | Wave DAG（只装功能 Wave，整体回归归 CW test 阶段） | Wave 并行 subagent + 测试‖review worktree 隔离 |
| 任务追踪 | design_status 状态机 | todo（isVerification）+ goal（方向/预算） |
| 复盘 | coding-closeout 沉淀长期文档 | coding-retrospect 轻量自检清单 |
coding-execute 启动前 [MANDATORY] 自检。以下任一信号出现 → 停止 lite，建议改用 full 工作流：
小功能的判定不是"代码行数少"，而是"改动是否触及架构契约"。加一个工具函数是 lite；改一个扩展的状态机是 full。
| 文件 | 作用 | 何时读 |
|---|---|---|
references/wave-model.md | Wave 拆分原则（垂直切片、依赖推导、并行组判定） | lite-plan 写 Wave 表前 read |
references/test-case-schema.md | 单测/E2E 用例表格 schema + 可机器判定规范 + 覆盖率 gate | lite-plan 写测试清单前 read |
references/subagent-dispatch.md | implementer/test-runner/code-review 三种 subagent 的 agent 定义模板 + 派发指令 + worktree 隔离编排 | coding-execute 派 subagent 前 read |
兄弟 skill（lite-plan / coding-execute / coding-retrospect）引用本目录文件，
必须用 ../lite-shared/references/{file}.md —— 相对路径的解析基准是当前 skill 的 baseDir
（SKILL.md 的 dirname），../ 跨到兄弟目录 lite-shared/。
不要用裸路径 lite-shared/references/...：那会解析成 {当前skill}/lite-shared/...，安装态下 broken。
