| 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 |
lite-shared（共享参考，不可主动调用）
这是一个物理载体 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 轻量自检清单 |
何时升级到 full（范围守门）
coding-execute 启动前 [MANDATORY] 自检。以下任一信号出现 → 停止 lite，建议改用 full 工作流：
- 需要跨 2 个及以上子系统/模块协调
- 涉及状态机变更、核心数据模型变更、公共 API 契约变更
- 需要架构决策（技术选型、模块边界重新划分、依赖方向调整）
- 改动会影响 3 个以上既有文件的核心逻辑（非测试文件）
- 需要非功能设计（安全/并发/性能/稳定性等 NFR 风险分析）
小功能的判定不是"代码行数少"，而是"改动是否触及架构契约"。加一个工具函数是 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。
