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

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

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

## 文件清单

| 文件 | 作用 | 何时读 |
|------|------|--------|
| `references/loop-skeleton.md` | 6 步操作骨架（Step 1-6c）+ subagent 派发模板 | 每个设计阶段 Step 1 前 read |
| `references/loop-method.md` | 方法论详解（Grilling 提问法、Question Hierarchy、gap 信号） | 仅首次执行工作流（clarity 阶段）read 一次 |
| `references/review-agent.md` | Step 6 独立审查 subagent 规范（机器检查优先 + 6 维审查） | Step 6 派审查 subagent 时注入 |
| `references/context-builder.md` | Step 1.0 上下文构建 subagent 规范（压缩上游→阶段工作摘要，对抗 compact 丢决策） | architecture 及之后各阶段 Step 1.0 派发时注入（L2/L3） |

## 引用约定（重要）

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

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

> **HTML 渲染不在此处。** Step 5b 的 `.html` 渲染由本包内置的 **coding-visualizer**
> 技能承担（无需 `pi install`），派 fresh subagent 加载该技能生成。它整合了 Mermaid + drawio + 手画 HTML/CSS
> 三种渲染引擎，按各阶段主角图类型自动选择。设计阶段特有的「主角图表」
> 映射见 `loop-skeleton.md` Step 5b。