lite-shared

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。