关于 toc-builder
toc-builder 是用于设计和审查项目变革理论的技能，面向项目团队和评估人员。它从长期成果逆向梳理路径，并明确因果主张、假设、权力分析、威胁和证据需求。
主要功能
- 01从明确愿景逆向推导
- 02按时间跨度梳理前提条件
- 03说明因果主张和假设
- 04运用女性主义政治经济学视角
- 05识别替代解释和其他贡献
- 06规划用于检验假设的证据
适用场景
- 01为新项目制定变革理论
- 02审查或修订现有变革路径
- 03准备资助方要求的 ToC 申报材料
- 04评估因果联系和证据缺口
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/toc-builder确认已加载。
详细介绍
变革理论构建器
ToC 不是带箭头的逻辑模型，而是关于变革如何发生的论证，其中的假设清晰可见且可检验。此技能确保达到这一标准。
适用场景
适用于变革理论相关工作：新项目设计、ToC 修订、路径分析、项目逻辑审查、资助方要求提交 ToC，或 ToC 评议。
不适用于常规成果框架、逻辑框架或指标列表——这些工作都以 ToC 为基础。
必需输入
一次性询问以下信息。未获取前四项前，不要开始起草。
- 长期成果或愿景：Ane 希望项目助力实现的变革，须用目标人群能够理解的语言表述（必需）
- 目标人群和背景：涉及哪些人、地点，以及哪些限制因素影响他们的生活（必需）
- 项目范围：项目实际能够实施哪些干预措施（必需）
- 时间范围：短期（12 mo）、中期（3 yr）、长期（5-10 yr）节点（必需）
- 现有分析：既往 ToC、需求评估或评估结果（可选）
- 女性主义政治经济分析：在这一体系中谁掌握权力，性别及其他因素如何影响资源获取（可选，但 SRHR 项目必需；如缺失，将提示补充）
方法
从长期成果倒推，绝不要从活动正向推演。
第 1 步 — 阐明愿景
用一句话写出长期成果。必须具体到可以证伪。“改善 SRHR 成果”不合格。“[region] 的青春期女孩无需第三方同意，即可在 30 分钟路程内获得优质避孕服务”合格。
第 2 步 — 确定前提条件
长期成果要成立，必须具备哪些条件？列出中期和短期阶段的前提条件。每项前提条件本身都应是一个变化状态，而不是一项活动。
第 3 步 — 明确因果关系
对于前提条件之间的每一条关联，说明：
- 因果主张：在当前背景下，为什么 A 会促成 B？
- 假设：要让 A 确实促成 B，项目控制范围之外的哪些条件必须成立？
- 证据状态：已检验（注明来源）、合理（注明框架）或未检验（标出证据缺口）
第 4 步 — 运用女性主义政治经济视角
即使项目没有标记为 SRHR，也不要跳过此步骤。针对每个节点：
- 这项变革符合谁的利益？又威胁谁的利益？
- 要让这项变革持续下去，哪些权力关系必须改变？
- 哪些人参与定义了这一成果？咨询过谁？哪些人共同设计了方案？
如果无法回答这些问题，请为该前提条件标注 ⚠️ Feminist political economy analysis missing。
第 5 步 — 识别 ToC 面临的威胁
根据 Mayne（2019）：如果项目没有开展，还有哪些其他解释可以说明预期变革？其他可能的贡献因素有哪些？请列出。
第 6 步 — 明确贡献问题
写出 ToC 最终必须回答的评估问题。采用 Mayne（2019）的表述：“在考虑其他贡献因素和背景的情况下，项目在多大程度上、以何种方式促成了[成果]？”
第 7 步 — 规划证据
针对每项假设，说明：
- 有什么证据可以证实它？
- 有什么证据可以证伪它？
- 哪种数据来源可以提供这些证据？
- 何时会根据证据重新审视 ToC？
输出结构
生成一份 ToC 文档，包含以下 H2 标题下的章节：
- 愿景 — 一句话，如步骤 1 所述
- 背景与人群 — 最多两段
- 路径图 — 文本表示：每项前置条件作为一个节点，每条连线用一句话描述。如果用户需要可视化内容，则生成 Mermaid 源码。
- 按时间范围划分的前置条件 — 三列（短期／中期／长期），每项前置条件占一行
- 因果主张与假设 — 表格：起点 → 目标、因果主张、假设、证据状态
- 女性主义政治经济分析 — 按节点记录权力与参与情况
- 对 ToC 的威胁 — 竞争性解释及其他贡献
- 贡献问题 — 一句话
- 证据计划 — 表格：假设、支持性证据、反证、数据来源、复查日期
- 数据缺口 — 对所有缺失信息使用
⚠️ Data gap:条目
引用要求
每项框架主张都须引用作者和年份。以下版本为必引版本：
- Vogel（2012）《Review of the Use of 'Theory of Change' in International Development》（DFID）
- van Eerdewijk 等人（2017）《White Paper: A Conceptual Model of Women and Girls' Empowerment》（KIT）
- Mayne（2019）《Revisiting the Contribution Question》，Evaluation 25(3)
- 相关时，引用 Cornwall 和 Rivas（2015）的女性主义框架
写作规则
遵循 CLAUDE.md 的风格指南。因果主张中不得含糊其辞——如果主张尚不确定，应说明证据尚未检验。不得有逻辑跳跃——如果步骤 3 无法指出因果机制，请将该连线标记为 ⚠️ Untested mechanism。
限制
此技能不会生成指标。ToC 稳定后，请转交给 indicator-designer。它不能替代利益相关方咨询，而是用于梳理 Ane 从该咨询中带来的分析。
编辑保留协议
如果 Ane 引用现有输出的路径并要求改进、迭代或扩展，则启用此协议。先读取文件，使用 Edit 工具在限定范围内编辑，将范围外的内容逐字节保留不变，并返回 EDIT-PRESERVATION DELIVERY 摘要。
如果目标文件存在，请应用 mel_wiki/wiki/concepts/edit-preservation-protocol.md。