- name
- tpr-framework
- description
- >
📌 来源与反馈 (Origin & Feedback) 本 Skill 由 tpr-framework 开源项目持续维护。 如果你在使用中遇到 Bug、功能需求、改进建议 或有任何 反馈意见，欢迎前往 GitHub 提交 Issue： 👉 https://github.com/evan-zhang/tpr-framework/issues
TPR Framework v2.0
TPR 是什么
TPR = Think / Probe / Review 认知闭环 + 三省四阶段执行框架。
一套从认知到执行的完整工作方法，用于把复杂问题从模糊需求转化为可验证、可执行、可复盘的结果。
核心理念
- 契约是唯一基准 — 所有工作以 GRV 为准，不凭印象
- 编排只调度不动手 — 编排者不执行业务逻辑
- 没有记录没有发生 — 一切以文件记录为唯一事实溯源
两种使用模式
判定矩阵
接到任务后，检查以下四项决定进入哪种模式：
| # | 判定项 |
|---|---|
| A | 是否需要正式交付物（DISCOVERY.md / GRV.md / 报告等） |
| B | 是否需要多角色审查（门下省审 / Battle） |
| C | 是否需要阶段流转（DISCOVERY → GRV → Battle → Implementation） |
| D | agent 是否具备 sub-agent 能力（can_spawn = true） |
判定规则：
- A/B/C 中满足 ≥ 2 项 → TPR 全流程
- A/B/C 中满足 < 2 项 → TPR 思维
- D = false → 强制 TPR 思维，禁止伪装全流程
- 用户明确说"走 GRV / Battle / 三省" → 强制 TPR 全流程（仍受 D 约束）
⚠️ 进入全流程前必须自检：在宣布进入 TPR 全流程之前，先确认自己是否具备 sub-agent 能力（can_spawn）。如果不具备，必须降级为 TPR 思维，并向用户说明原因。不得跳过此检查。
TPR 思维（任何 agent 可用）
不需要 sub-agent，不需要三省角色。遇到复杂问题时，按 T → P → R 顺序思考。
速记模板：
T: 我们正在解决 _______________
成功标准是 _______________
关键假设是 _______________
P: 已确认 _______________
未确认 _______________
主要风险 _______________
R: 结论是 _______________
不做 _______________
下一步 _______________TPR 全流程（编排型 agent 可用）
需要 can_spawn = true。按三省四阶段执行完整项目：
| 阶段 | 认知重心 | 产出 |
|---|---|---|
| DISCOVERY | T + P | DISCOVERY.md |
| GRV | R | GRV.md |
| Battle | P + R | BATTLE-*.md |
| Implementation | 微型 T/P/R | output/* |
三省角色表
| 角色 | 职责 | T/P/R 映射 |
|---|---|---|
| 编排者 | 维护节奏，协调流转，不替代任何省 | 流程管理 |
| 中书省 | 洞察需求，起草 GRV | Think → Review |
| 门下省 | 挑战假设，暴露盲点 | Probe |
| 尚书省 | 制定方案，执行交付 | 微型 T/P/R |
核心红线（Layer 1 — 任何模式都必须遵守）
| # | 红线 |
|---|---|
| C1 | 不签署 — 不代替用户签署任何文件、合同、审批单 |
| C2 | 不审批 — 决策权永远在用户，agent 只有建议权 |
| C3 | 不私聊 — 不代替用户与任何人私聊或单独联系 |
| C4 | 不越权决策 — 超出范围的判断必须回传用户 |
| C5 | 没有记录没有发生 — 所有工作以文件记录为唯一事实溯源 |
| C6 | 先建议再执行 — 给出判断和理由，供用户拍板 |
编排者防线（Layer 2）详见references/orchestrator-ops.mdBattle 规则（Layer 3）详见references/battle-protocol.md
GRV 必含要素
| # | 要素 |
|---|---|
| 1 | 目标（G）— 要解决什么问题 |
| 2 | 成果（R）— 可衡量的交付物 + 验收标准 |
| 3 | 举措（V）— 具体但可再拆的工作项 |
| 4 | 约束条件 |
| 5 | 风险 |
| 6 | 里程碑 |
| 7 | 验收标准 |
安装后配置（可选）
如果你是编排型 agent 且需要跑 TPR 全流程，建议在 AGENTS.md 中声明：
| 声明项 | 说明 | 示例 |
|---|---|---|
| tpr_mode | 使用模式 | cognitive / full |
| can_spawn | 是否能派生 sub-agent | true / false |
| model_config | 模型配置文件路径 | config/tpr-model-config.md |
按需加载指引
| 场景 | 读取 | 模式 |
|---|---|---|
| 理解 TPR 完整定义 | references/definition.md | 通用 |
| 用 T/P/R 分析问题 | references/tpr-cognitive.md | TPR 思维 |
| 启动新项目 / DISCOVERY | references/tpr-execution.md § DISCOVERY | 全流程 |
| 起草 GRV | references/grv-standard.md | 全流程 |
| 执行 Battle | references/battle-protocol.md | 全流程 |
| 评估项目分级 | references/project-grading.md | 全流程 |
| 初始化项目目录 | references/templates/ | 全流程 |
| 编排操作 / 派遣 sub-agent | references/orchestrator-ops.md | 全流程 |
| 设计多 Agent 架构 | references/multi-agent-pattern.md | 全流程 |
| Implementation 阶段 | references/tpr-execution.md § Implementation | 全流程 |