name: phx:brief description: 计划文件的交互式简报。以渐进式部分解释推理和解决方案，让开发者在批准前或完成后理解。当团队成员需要理解计划而无需阅读完整文档时使用。 argument-hint: [计划文件路径]
计划简报
计划的推理、决策和解决方案形状的交互式逐步讲解。专为需要在1-2分钟内理解计划而不阅读完整文档的开发者设计。
为什么存在
计划回答“做什么”但埋藏了“为什么”。此技能通过交互式逐步讲解来弥合这一差距。
用法
/phx:brief # 最新计划
/phx:brief .claude/plans/user-auth/plan.md # 特定计划
参数
$ARGUMENTS= 计划文件路径（可选，自动检测最新）
模式检测
读取计划文件并根据阶段状态确定模式：
- 所有阶段
[PENDING]= 工作前简报（将会发生什么） - 任何阶段
[COMPLETED]或[IN_PROGRESS]= 工作后简报（做了什么及为什么）
执行流程
步骤1：定位和加载计划
-
如果
$ARGUMENTS有路径，使用它 -
否则，找到最新计划：
ls -t .claude/plans/*/plan.md 2>/dev/null | head -1 -
如果未找到计划，告诉用户并建议
/phx:plan -
读取计划文件
步骤2：加载支持工件
读取可用内容（如果缺少则不失败）：
.claude/plans/{slug}/summaries/consolidated.md（研究摘要）.claude/plans/{slug}/scratchpad.md（决策、死胡同）.claude/plans/{slug}/progress.md（工作日志，仅工作后）
步骤3：呈现简报部分
一次呈现一个部分，包裹在视觉简报块中（见 references/briefing-guide.md 视觉格式）。每个部分后，使用 AskUserQuestion 选项：
- 如果还有剩余部分：“下一个：{标题}”，“问我关于此的问题”，“停止这里”
- 如果是最后部分：无需问题，显示关闭消息
部分流程（工作前模式）
| # | 标题 | 来源 |
|---|---|---|
| 1 | 我们要构建什么 | 摘要 + 范围 |
| 2 | 关键决策 | 技术决策 + scratchpad 理由 |
| 3 | 解决方案形状 | 阶段概述 + 数据模型 |
| 4 | 风险与信心 | 风险表 + 未知/尖峰 |
部分流程（工作后模式）
| # | 标题 | 来源 |
|---|---|---|
| 1 | 构建了什么 | 摘要 + 完成状态 |
| 2 | 关键决策及原因 | 技术决策 + scratchpad |
| 3 | 如何构建的 | 阶段与实现笔记 |
| 4 | 教训与模式 | 遇到的风险 + 使用的模式 |
见 references/briefing-guide.md 获取部分内容模板。
铁律
- 一次一个部分 — 从不倾倒所有内容
- 用户控制节奏 — 始终提供停止选项
- 解释为什么，不仅仅是是什么 — 理由超过列表
- 基于工件 — 专注于此计划研究、决策和scratchpad条目的具体洞察，而非一般编程概念
- 保持每个部分不超过20行 — 这是简报，不是讲座
关闭消息
最后部分后（或用户停止时）：
这就是简报！详情请见：
{plan_path}
准备继续？尝试 `/phx:work {plan_path}` 开始执行。
工作后变体：
这就是构建的内容！详情请见：
{plan_path}
考虑 `/phx:compound` 以捕获关键学习供将来参考。
集成
/phx:plan --> /phx:brief (可选) --> /phx:work --> /phx:brief (可选)
创建 执行前理解 执行 执行后理解
笔记
- 在主对话上下文中运行（非子代理）
- 模型：无特殊要求 — 使用默认会话模型
- 无工件写入 — 简报是短暂的，计划即是工件
- 参考文件可读，因为技能在用户会话中运行