Anonymousyz/research-to-decision-toolkit

# 研究到决策工具包 一个公开的工具包，用于将开放研究转化为有证据支撑的决策、可复用的产出物以及公开的反馈循环。 ``` problem → evidence → judgment → artifact → feedback → iteration ``` 本工具包面向研究员、政策分析师、咨询从业者、产品负责人、独立开发者以及一线工程师，他们希望让自己的研究对外行人也明显有用——而不仅仅是在自己的组织内部有用。 它**不是**： - 个人生产力系统； - 日记系统； - 项目管理工具； - 领域专业知识的替代品。 它**是**： - 一小部分可复用的画布、模板和提示词； - 一种将证据与判断、兴奋感区分开的方法； - 一种将研究发布为他人可复制的产出物的方法； - 一种在不依赖封闭网络的情况下运行公开反馈循环的方法。 ## 30秒价值主张 当有人说： 使用本工具包来： 1. 在收集更多证据之前，界定真正的决策。 2. 将你所知的内容整理成证据矩阵。 3. 区分事实、假设与判断。 4. 决定最终结果应该是备忘录、模板、工具还是出版物。 5. 发布公开产出物，并记录反馈回来的信号。 ## 仓库目录 | 领域 | 文件 | 目的 | |---|---|---| | 理念 | [`MANIFESTO.md`](MANIFESTO.md) | 为什么研究需要产出物，以及产出物需要反馈 | | 界定决策 | [`templates/problem-framing-canvas.md`](templates/problem-framing-canvas.md) | 将模糊的主题转化为真正的决策问题 | | 组织证据 | [`templates/evidence-matrix.md`](templates/evidence-matrix.md) | 将主张分类为事实、判断、假设、空白 | | 决定行动 | [`templates/decision-memo.md`](templates/decision-memo.md) | 一份能产生真正决策的简短备忘录 | | 决定产出物 | [`templates/public-artifact-brief.md`](templates/public-artifact-brief.md) | 决定结果是将变成 repo、文章、工具还是工作坊 | | 收集反馈 | [`templates/feedback-log.md`](templates/feedback-log.md) | 在不过度拟合的情况下记录公开反馈信号 | | 评估准备度 | [`scorecards/decision-readiness-scorecard.md`](scorecards/decision-readiness-scorecard.md) | 用于决策会议准备度的透明 24 项二元评分表 | | 对承诺进行红蓝对抗 | [`modules/decision-review/`](modules/decision-review/) | 备选方案、脆弱假设、事前验尸、红队提示词及人工审查评分表 | | AI 提示词 | [`prompts/research-synthesis-prompt.md`](prompts/research-synthesis-prompt.md), [`prompts/critical-review-prompt.md`](prompts/critical-review-prompt.md), [`prompts/public-artifact-transform-prompt.md`](prompts/public-artifact-transform-prompt.md) | 使用 AI 进行起草、压力测试和转换 | | 示例 | [`examples/fictional-ai-governance-research-to-decision/`](examples/fictional-ai-governance-research-to-decision/) | 一个虚构的端到端案例 | | CLI | [`src/r2d`](src/r2d), [`docs/cli.md`](docs/cli.md) | 在本地初始化、验证、评分并报告决策摘要 | | 测试 | [`tests/test_r2d.py`](tests/test_r2d.py) | Schema、评分不变性、否决、报告和 CLI 行为 | | CI 模板 | [`docs/github_actions_validate.template.yml`](docs/github_actions_validate.template.yml) | 可直接复制的验证工作流；在具有 `workflow` scope 的 token 可用之前，特意保持未激活状态 | | 方法边界 | [`docs/method_status.md`](docs/method_status.md) | 解释该评分能证明和不能证明什么 | | 快速入门 | [`docs/quickstart.md`](docs/quickstart.md) | 10分钟完成你的第一份决策摘要 | | 来源 | [`SOURCES.md`](SOURCES.md) | 该方法的出处 | | 路线图 | [`docs/roadmap.md`](docs/roadmap.md) | 本 repo 下一步的发展方向 | ## 快速开始 ### 选项 A — 手动 1. 打开 [`templates/problem-framing-canvas.md`](templates/problem-framing-canvas.md) 并写下真正的决策问题。 2. 将主张移至 [`templates/evidence-matrix.md`](templates/evidence-matrix.md)。 3. 使用 [`templates/decision-memo.md`](templates/decision-memo.md) 生成备忘录。 4. 使用 [`templates/public-artifact-brief.md`](templates/public-artifact-brief.md) 选择产出物形式。 5. 使用 [`scorecards/decision-readiness-scorecard.md`](scorecards/decision-readiness-scorecard.md) 决定该摘要是否已准备好进入决策会议。 6. 发布后，在 [`templates/feedback-log.md`](templates/feedback-log.md) 中记录反馈。 ### 选项 B — CLI ``` python -m venv .venv . .venv/bin/activate # Windows: .venv\Scripts\activate python -m pip install -e . r2d init my_decision_brief.json r2d validate examples/fictional-ai-governance-research-to-decision/decision_brief.json r2d score examples/fictional-ai-governance-research-to-decision/decision_brief.json r2d report examples/fictional-ai-governance-research-to-decision/decision_brief.json --output decision_report.md ``` 预期输出： ``` Decision: Ready for decision meeting Total: 23/24 Normalized: 95.8% Veto: no Top gaps: - feedback log is not yet filled ``` 详见 [`docs/cli.md`](docs/cli.md)。 ## 如何阅读本仓库 如果你只有 5 分钟： 1. 阅读本 README。 2. 阅读 [`MANIFESTO.md`](MANIFESTO.md)。 3. 浏览 [`examples/fictional-ai-governance-research-to-decision/`](examples/fictional-ai-governance-research-to-decision/)。 如果你有 30 分钟： 1. 阅读宣言、快速入门和路线图。 2. 用你自己的素材从头到尾走一遍某个模板。 如果你有 2 小时： 1. 从零开始复现那个虚构案例。 2. 根据你所在的领域调整每个模板。 3. 尝试使用 CLI。 ## 不在范围内及方法边界 - 不能替代法律、安全、合规或医疗建议； - 不保证任何具体决策的正确性； - 不是项目管理或任务跟踪工具； - 不是内容日历。 它是一个结构化的起点，用于推动研究从私人想法走向可审查的证据、可问责的决策会议、可复用的产出物以及反馈。AI 生成的挑战内容仅作为起草材料——不能作为来源证据或独立审查。 ## 许可证 MIT。详见 [`LICENSE`](LICENSE)。

标签：决策支持, 文档结构分析, 模板, 知识管理, 研究工具, 红队模块, 逆向工具