📌 来源与反馈 (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.md Battle 规则（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 | 全流程 |