需要产出学习议程（年度联邦议程…

当需要起草、刷新或适配组织学习议程（含年度学习问题、季度RAG状态看板、成员协会适配模板）时，按USAID+Patton混合框架产出结构化文档。

适用场景

解决思路

1. 先确认输出类型：canonical（v1完整联邦议程）、fragment（单问题条目）、rag-dashboard（v2季度一页看板）或ma-template（v3成员协会适配模板）；若缺失或含糊，一次性向请求者确认。
2. 一次性收集全部必需输入：输出类型、周期名称、联邦战略背景（v1必需）、问题清单（可选）、锚定的v1路径（v2/v3必需）、周期（v2必需）、状态更新（v2可选）、MA名称（v3必需）、MA战略背景（v3必需）、MA问题清单（v3可选）、跨MA命名约定（可选，默认name）。
3. 会话开始时完整阅读SKILL.md，阅读对应输出类型的范例文件（learning-agenda-exemplar-v[1|2|3].md），阅读框架基础文件（learning-agenda-usaid-cla-2022.md 和 utilisation-focused-knowledge-management.md），阅读 ~/.claude/CLAUDE.md 的受众层级语域部分。
4. 按顺序加载源材料：对应范例、USAID CLA框架页、利用导向知识管理框架页、v2/v3所需的v1文件、design-brief的Decisions locked部分。
5. 应用A+C混合纪律：USAID文档结构 + 每个Tier 1问题的Patton使用锚定 + 年度刷新部分的Britton式AAR姿态。
6. Tier 1问题必须同时具备USAID四要素（问题+方法+决策+使用计划）和Patton三锚（决策者+使用承诺+使用倡导者）；缺任一锚则标记 ⚠️ Tier 1 anchor incomplete — confirm or downgrade to Tier 2。
7. Tier 2问题只带方法+指示性用例，不要求具名决策者。
8. 保持Tier 1/Tier 2约60/40比例，Tier 1占主导；全Tier 2或全Tier 1均不合格。
9. v1使用初级MEL语域：框架名可见、callout框（common pitfall、why this matters、worked example）、术语表脚注、带注释的证据基础；v2和v3使用Tier 1工作简报默认语域，无callout、无术语表、紧凑。
10. 跨MA命名默认用MA名称（锁定决策11）；国家级命名触发provenance footer中的redaction-candidate标记。
11. 引用仅来自wiki框架页，不引入新来源；格式为作者姓+年份+出处+章节；URL复用wiki中已验证的链接，未验证的标 ⚠️ URL unverified。
12. 句子控制在25词以内，主动语态，正文不用破折号，避免名词化；盎格鲁-撒克逊词优先于拉丁词；缩写首次出现时拼全。
13. 若议程含受限于已验证来源的叙事性文字，该子步骤可用Fable按次覆盖起草，但必须运行Sonnet上的prose-fidelity gate（Gate 2），所有标记清除后方可纳入。
14. 需要Word/PPTX/PDF产物时，通过 ane_package.reporting 品牌模板入口；不硬编码颜色、字体或格式。
15. 每个输出末尾加 ## How this <agenda|dashboard|template> was made 块：一段说明来源design brief、周期名、语域、品牌模板路径；**Cross-MA references named:** 行；**Redaction note:** 段；v2/v3加 **Companion artefacts in the three-exemplar series:** 行。
16. v1结构：标题块、执行摘要、如何阅读本议程、周期背景与设计选择、十二个学习问题（Tier 1×7在前，Tier 2×5在后）、调查投入摘要表、审查检查点、制作说明、术语表（12–18条）、带注释的证据基础。
17. v1长度5000–7000词（硬上限8000），问题数12（范围8–15）；至少1个Why this matters、1个Common pitfall、1个Worked example callout；年度刷新部分明确命名Britton (2005) AAR姿态并给出AAR开场示例。
18. v1中当两个及以上问题双向关联时，在两个问题条目中均以 **Cross-question coherence** 行命名该关联。
19. fragment结构（Tier 1）：层级与问题标签、问题、方法、决策、使用计划、决策者、使用承诺、使用倡导者、层级、跨问题一致性、问题证据基础、最小provenance footer；Tier 2 fragment为1–5+9+11+12项，第5项改为Indicative use case，第9项加Why Tier 2理由。
20. fragment长度：Tier 1为250–500词，Tier 2为150–300词；不生成术语表、执行摘要或带注释证据基础；Tier 1 fragment缺任一Patton锚必须内联标记。
21. v2结构：标题块、Headline（30秒BLUF）、Tier 1 RAG状态表、Tier 2 RAG状态表、本季度变化、Tier 2观察清单、Tier 2考虑删除清单、下次看板前的行动项、证据基础行。
22. v2长度1页（约600词，硬上限2页）；单行每问题表格；Headline在表格前；观察清单和删除清单为必填；行动项带日期和具名责任；默认3色RAG（🟢🟠🔴），若提供4色约定则切换；未提供状态更新时生成示意看板并标记 ⚠️ Illustrative。
23. v3结构：标题块、MA周期背景（200–400词）、锚定问题（2–4条）、MA特定学习问题（Tier 1带锚+Tier 2不带，共3–5条）、方法库与调查投入表、审查节奏（6个月一次）、使用承诺快速参考表、证据基础、制作说明。
24. v3长度1500–2500词，问题数4–8个MA特定+2–4个联邦锚定；锚定部分在MA特定部分之前；方法库限于MA能力（内部定性跟踪、焦点小组、轻量案头审查、HR记录、同行协助），不提议委托多国评估；使用承诺命名MA级决策者；节奏为6个月一次（典型5月+11月）；provenance footer含MA自主性说明（联邦不批准MA议程）。
25. 若MA名称不在活跃IPPF EN联邦列表中，标记 ⚠️ MA not recognised — confirm spelling and federation status。
26. 若任一框架wiki页超过12个月，在provenance footer中加 ⚠️ Source framework page older than 12 months — verify still current。
27. 若请求者引用已有输出路径并要求改进/迭代/扩展，先读文件，用Edit工具做范围受限编辑，范围外内容保持字节一致，返回EDIT-PRESERVATION DELIVERY摘要。
28. v1可应请求通过 ane_package.reporting.word_export.write_word_report 生成Word；v2可应请求通过 ane_package.reporting.pdf_export.write_pdf_report 生成PDF；v3可生成Word供MA MEL协调员交接。

适用边界 · 注意事项

• 不要用于从Researcher Evidence Brief衍生的学习产品——那是 learning-product 技能。
• 不要用于一般决策备忘录（decision-memo技能）、一般组织学习框架（evidence-synthesis技能）、项目M&E计划/结果框架/指标集，或回答学习议程问题的Researcher Evidence Brief（researcher技能）。
• 不要用于运行年度刷新工作坊、跨周期跟踪利用情况、决定是否对外发布，或替代MA对MA特定问题的判断。