full-shared

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。