mcpField
L
learning-agenda

learning-agenda

github.com/gasserane文档处理3628 次安装6 天前更新
代码仓库

关于 learning-agenda

learning-agenda 是用于编写联合会学习议程、季度 RAG 仪表板或成员协会适配模板的技能。它按问题层级、使用锚点、来源规则和各输出类型的结构要求组织内容。

主要功能

  1. 01提供议程、仪表板和模板三种输出
  2. 02支持单个问题条目模式
  3. 03按层级设置问题与使用锚点
  4. 04规定来源和引用要求
  5. 05添加来源说明与命名备注

适用场景

  1. 01起草年度联合会学习议程
  2. 02编制季度议程状态仪表板
  3. 03为成员协会调整议程
  4. 04审阅或构建单个学习问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/gasserane/personal-skills --skill learning-agenda

安装后在 Claude Code 中输入/learning-agenda确认已加载。

详细介绍

学习议程

三种输出类型。v1 = 标准联邦学习议程(年度常设文件)。v2 = 季度 1 页 RAG 仪表板。v3 = MA 适配模板,各会员协会用它将自身议程与联邦议程衔接起来。该技能遵循 2026-05-10 锁定的 A+C 混合规范:采用 USAID 文件结构,并针对每个问题锚定 Patton 式应用,同时在年度更新中采用 Britton 式行动后复盘姿态。

使用时机

出现以下任一情况时触发:

  • “学习议程”、“联邦学习议程”、“年度学习问题”
  • 与议程相关的“RAG 仪表板”;“学习议程季度状态”
  • “MA 学习议程”、“MA 适配模板”、“MA 级学习议程”
  • “更新议程”、“起草 2027 周期议程”、“联邦 MEL 年度更新”
  • 明确指定输出类型(v1、v2、v3、canonical、rag-dashboard、ma-template)

以下情况不要触发:

  • 根据 Researcher Evidence Brief 衍生的学习产品——这属于 learning-product 技能
  • 通用决策备忘录——这属于 decision-memo 技能
  • 通用组织学习框架——这属于基于 organisational-learning-senge-argyris wiki 页面运行的 evidence-synthesis 技能
  • 项目 M&E 计划、成果框架、指标集——这些属于单独的技能
  • 用于回答学习议程问题的 Researcher Evidence Brief——这属于 researcher 技能

必需输入

请一次性询问以下输入。标记为必需的输入在调用时必须提供;标记为可选的输入使用默认值。

  1. 输出类型(必需):以下之一:canonical(v1,完整联邦议程)、fragment(单个问题条目——v1 的一种子模式,生成一个 Tier 1 或 Tier 2 问题条目,不包含完整文档框架;用于验证、对候选问题进行同行评审或迭代构建议程)、rag-dashboard(v2)、ma-template(v3)。
  2. 周期名称(必需):例如 2027、FY2027-28、2026-2028 biennium。用于标题区块和更新频率。
  3. 联邦战略背景(v1 必需;v2/v3 可选):一段文字,或指向战略计划更新文档的路径,其中列出影响该周期的战略压力。
  4. 问题列表(v1 可选):如果 Ane 提供学习问题列表及拟定的 Tier 1/Tier 2 分类,该技能会按议程格式整理这些问题。如果未提供,该技能会根据战略背景起草示例问题,并为每个问题标注 ⚠️ Reasoned default — confirm with federation MEL function。
  5. 已锚定的 v1 路径(v2 + v3 必需):v2 或 v3 所引用的标准议程文件路径。默认值:agent-improvements/learning-agenda-exemplar-v1.md(技能验证用示例);实际使用时,应填写当前周期标准议程的路径。
  6. 时期(仅 v2 必需):例如 Q2 2027。用于仪表板标题区块。
  7. 状态更新(v2 可选):每个问题的 RAG 状态 + 一行说明。如果未提供,该技能会生成示例状态并标注为示例。
  8. MA 名称(v3 必需):IPPF EN 会员协会名称(例如 IPPF <Country> (<acronym>)、IPPF Albania)。
  9. MA 战略背景(v3 必需):一段文字,说明影响 MA 议程的运营背景。
  10. MA 问题列表(v3 可选):MA 特定问题;如果未提供,该技能会根据战略背景起草问题,并标注为基于推理的默认内容。
  11. 跨 MA 命名约定(所有输出类型均可选):name(锁定决策 11 中的默认值)或 sub-region(脱敏回退方案)。使用国家级名称时,来源信息页脚会标记为候选脱敏项。

会话开始

  1. 完整阅读此 SKILL.md。
  2. 阅读与所请求输出类型对应的范例:agent-improvements/learning-agenda-exemplar-v[1|2|3].md。范例是结构参照。
  3. 如果尚未在当前会话上下文中阅读过,请阅读框架基础文档 mel_wiki/wiki/frameworks/learning-agenda-usaid-cla-2022.md 和 mel_wiki/wiki/frameworks/utilisation-focused-knowledge-management.md。
  4. 如果尚未在当前会话上下文中阅读过,请阅读 ~/.claude/CLAUDE.md 中的受众层级登记部分。

工作流

步骤 1 — 解析输入并确定路径

确定输出类型。如果缺失或不明确,请一轮询问 Ane:

“请选择输出类型:canonical(v1,年度联合议程)、rag-dashboard(v2,1 页季度状态)或 ma-template(v3,MA 适配模板)?”

如果选择了 ma-template,但未提供 ma-name 参数,请在同一轮询问中索取。

如果选择了 fragment,还需询问层级(1 或 2)以及问题文本。如果请求 Tier 1 片段,但上下文不足以确定 Patton 的三个锚点(决策者 + 使用承诺 + 使用倡导者),则根据联合战略背景拟定合理默认值,并为每个锚点标注 ⚠️ 合理默认值 — 发布前请确认。

步骤 2 — 加载源材料

按以下顺序阅读:

  1. agent-improvements/learning-agenda-exemplar-v[N].md — 所请求输出的结构参照。
  2. mel_wiki/wiki/frameworks/learning-agenda-usaid-cla-2022.md — 框架基础;USAID 四要素模板与 Patton 三锚点扩展定义。
  3. mel_wiki/wiki/frameworks/utilisation-focused-knowledge-management.md — 使用锚定的操作原则。
  4. 对于 v2 和 v3:提供的 v1 路径。
  5. agent-improvements/learning-agenda-design-brief.md 中的 “Decisions locked” 部分 — 塑造输出的 12 项规格会议决策。
步骤 3 — 应用输出类型子提示词

转到下方三个子提示词之一。每个子提示词都会根据输入内容,按照对应范例的结构生成输出。

第 4 步——应用质量门槛(适用于所有输出类型)

返回草稿前:

  • A+C 混合规范。 采用 USAID 文档结构 + Patton 对每个 Tier 1 问题的用途锚定 + 年度更新部分采用 Britton 风格的 AAR 方法(仅限 v1)。规范混用不完整会导致输出不完整。
  • Tier 1 规范。 每个 Tier 1 问题都包含:问题 + 方法 + 决策 + 使用计划(USAID 的四项要素),以及决策者 + 使用承诺 + 使用倡导者(Patton 的三个锚点)。缺少任何锚点时,标记 ⚠️ Tier 1 anchor incomplete — confirm or downgrade to Tier 2。
  • Tier 2 规范。 Tier 2 问题包含方法 + 指示性使用场景。按设计,它们不要求指定决策者(决策 7)。
  • Tier 1 / Tier 2 划分。 比例约为 60/40,以 Tier 1 为主。v1 全部采用 Tier 2,不符合 A+C 混合规范;v1 完全没有 Tier 2,则会退化为纯 Patton 方案(在规范评审会上已否决)。
  • 语体。 v1 采用初级 MEL 语体:显示框架名称,包含说明框(常见陷阱、这为何重要、示例)、词汇表页脚和注释版证据依据。v2 和 v3 默认采用 Tier 1 工作简报语体:不加说明框、不附词汇表,内容精简。
  • 跨 MA 命名。 默认的 name 按锁定决策 11 执行(与默认使用子区域的 learning-product 不同)。国家级命名会触发来源信息页脚中的脱敏候选项标记。
  • 引用位置。 仅当框架名称本身是 v1 初级 MEL 语体中的教学重点时,才使用文内引用;其他情况下,在章节末尾添加 **Evidence base:**。URL 沿用 wiki 中的链接,不得编造。
  • 引用严谨性。 适用时,注明作者姓氏、年份、出版载体和章节。仅使用框架 wiki 页面中已验证的 URL。此技能不得引入新来源。
  • 句子长度。 每句少于 25 个词。使用主动语态。正文中不使用破折号。能用动词时,不使用名词化表达。
  • 通俗英语。 尽量使用盎格鲁-撒克逊词汇,少用拉丁语源词。每份文档中,缩略语首次出现时须拼写全称。按照 ECA / SSA / MENA 读者的需求进行可翻译性测试。
  • 叙事散文模型 + 忠实度门槛(依据 agent-improvements/model-selection-policy.md)。如果议程包含受已验证来源约束的示例叙事散文(示例说明框、情景插入内容),可通过 Fable 单次调用覆盖来起草该叙事子步骤;若采用此方式,必须执行散文忠实度门槛(该政策中的 Gate 2),使用 Sonnet 对照来源进行检查,并在纳入前清除所有标记。结构化议程、仪表板和模板内容仍使用此技能自身的模型。
  • IPPF Visual Identity 2025。 如果需要 Word、PPTX 或 PDF 成品,请通过 ane_package.reporting 品牌模板入口处理。不得硬编码颜色、字体或格式。
第 5 步——来源信息页脚

每份输出的末尾都须包含 ## How this <agenda | dashboard | template> was made 区块:

  • 用一段文字说明来源设计简报(agent-improvements/learning-agenda-design-brief.md)、周期名称、采用的语体和品牌模板路径。
  • 添加一行 **Cross-MA references named:**,列出正文中提及的每个 MA。v1 默认列出 MA;v2 沿用 v1 列出的名称;v3 列出模板所针对的 MA,以及与联合会问题相关的 MA。
  • 添加一段 **Redaction note:**,说明默认命名政策和子区域回退方案。如果国家级命名涉及外部敏感案例,添加 **Redaction candidates:** 列表,供 Ane 手动审查。
  • 对于 v2/v3,添加一行 **Companion artefacts in the three-exemplar series:**,将另外两份输出交叉引用为 agent-improvements/learning-agenda-exemplar-v[N].md,或当前周期对应的文件。
步骤 6 — 返回

在助手回复中以文本形式返回草稿。如果 Ane 提出要求,v1(长篇版)也可以通过 ane_package.reporting.word_export.write_word_report 生成 Word 文档。如果 Ane 提出要求,v2(单页仪表板版)可以通过 ane_package.reporting.pdf_export.write_pdf_report 生成 PDF。如果 Ane 提出要求,v3(MA 模板)可以生成 Word 文档,以便移交给 MA MEL 协调员。


子提示词 — v1 — 联合会学习议程标准版

默认篇幅。 5,000–7,000 字(约 6–10 页)。硬性上限:8,000 字。少于 4,000 字则无法通过年度常设文件的实质性内容密度测试。

默认问题数。 12 个问题(一级问题 × 7 + 二级问题 × 5)。允许范围为 8–15 个(根据决策 5 所述的 USAID 指引范围)。少于 8 个则对于联合会级别的范围而言过于单薄;超过 15 个则会稀释探究能力。

必需结构(参照 learning-agenda-exemplar-v1.md):

  1. 标题栏 — 标题、受众(联合会 MEL 职能部门 + 高级管理层 + MEL CoP + 所有活跃 MA 的 MEL 负责人 + 新入职 MEL 人员)、周期、篇幅、文风(一级工作简报、面向初级 MEL 人员的语体)、更新日期、季度 RAG 时间表。
  2. 执行摘要 — 2 分钟可读完。一级 / 二级问题数量;与上一周期相比的前三项变化;指定一名统筹各问题的使用推动者。
  3. 如何阅读本议程 — 面向初级 MEL 人员的教学性补充内容。列出六个部分;解释选择初级 MEL 人员语体的原因;使用一个 **为何重要** 提示框。
  4. 周期背景与设计选择 — 战略框架;A+C 混合方案的理由;一个 **常见误区** 提示框;一行以初级 MEL 人员语体风格标注的 **设计依据**。
  5. 十二个学习问题 — 先列一级问题(7 个),再列二级问题(5 个)。每个一级问题均包含:问题;方法;答案将支持的决策;使用计划;决策者;使用承诺;使用推动者;级别(= 1);另附行内 **问题依据**。至少有一个一级问题包含 **示例 — 如何解读一级问题** 提示框(用于初级 MEL 教学)。每个二级问题均包含:问题;方法;示例性使用场景;为何列为二级;级别(= 2);另附行内 **问题依据**。
  6. 探究投入摘要 — 表格:问题 / 级别 / 方法 / 人员天数 / 直接成本。包含合计行。包含一级 / 二级拆分行,体现投入分配原则(一级问题占人员天数的 60–80%)。使用一个 **常见误区** 提示框说明该原则。
  7. 审查检查点 — 季度 RAG(轻量级、一页格式,指向 v2 示例)+ 年度更新(Britton AAR 方法)。至少有一个 **示例 — AAR 开篇是什么样的** 提示框(用于初级 MEL 教学)。
  8. 本议程的编制方式 — 按照步骤 5 说明来源信息 + 脱敏说明。
  9. 术语表 — 面向初级 MEL 人员的语体要求。列出议程中使用的 12–18 个 MEL 术语,每个术语用 1–2 行通俗英语解释。
  10. 带注释的证据基础 — 面向初级 MEL 人员的语体要求。每个引用来源附一行注释 [框架基础,请先阅读]、[实践应用,示例] 或 [进阶阅读]。

文风。 一级工作简报,面向初级 MEL 人员的语体。明确列出框架名称(在正文中提及 USAID 2022、Patton & Campbell-Patton 2022、Britton 2005、Lavis et al. 2009、Weiss 1979)。包含提示框(常见误区、为何重要、示例)。附术语表。附带注释的证据基础。该语体既适用于首次接触 MEL 框架概念的员工,也适用于将议程用作工作参考的资深 MEL 负责人。

v1 特有的质量标准:

  • 每个 Tier 1 问题都包含 Patton 的三个锚点(决策者 + 使用承诺 + 使用倡导者)。缺少任一锚点的 Tier 1 问题必须标记为 ⚠️ Tier 1 anchor incomplete — confirm or downgrade to Tier 2,不得在未提示的情况下作为 Tier 1 输出。
  • Tier 1 / Tier 2 的比例约为 60/40(目标为 12 个问题中 7/5)。偏移到 9/3 或 11/1 会使议程过度偏向纯 Patton;偏移到 4/8 或 3/9 则会使议程过度偏向研究议程。
  • 面向初级 MEL 人员的教学插入内容至少应包含:1 个 **为什么这很重要** 提示框、1 个 **常见陷阱** 提示框、1 个 **示例演练** 提示框。可以更多;少于此数量则不符合文体要求。
  • 根据已锁定的决策 11,跨 MA 命名默认使用 MA 名称。子区域标签仅作为删改后的替代方案。
  • 年度更新部分必须明确提及 Britton(2005)的 AAR 方法立场,并提供 AAR 开场白的示例。
  • 术语表应涵盖新入职的 MEL 人员初读时可能不熟悉的术语;不必涵盖所有术语,但应包括关键术语(通常为 12–18 个)。
  • 注释后的证据基础应列出每个框架来源及其用途(先读 / 进阶 / 示例演练)。仅有不带注释的 **证据基础:** 行不符合面向初级 MEL 人员的文体要求。
  • 议程中的 Tier 1 / Tier 2 指使用承诺层级,而非 ~/.claude/CLAUDE.md 中的受众层级分类。技能说明应区分两者;Tier 1 / Tier 2 的术语表条目应明确说明这一区别。
  • 跨问题连贯性。 当议程中的两个或更多问题存在双向关联(一方为另一方提供信息,或一方深化另一方)时,必须在两个问题条目中都点明这种关联——通常在条目中的 **跨问题连贯性** 一行说明。这样,当问题构成分析序列时,就不会显得彼此孤立。

子提示词 — 片段 — 单个 Tier 1 或 Tier 2 问题条目

适用场景。 验证运行(依据 agent-improvements/learning-agenda-validation-input.md);将候选问题加入议程前进行同行评审;迭代构建议程,用户在提交本轮议程前逐次测试一个问题。

默认长度。 Tier 1 条目为 250–500 词;Tier 2 条目为 150–300 词。

必需结构(Tier 1 片段):

  1. Tier 和问题标签 — 例如 “TIER 1 — Q1(片段)” 或 “TIER 1 — 单问题条目”。
  2. 问题 — 聚焦、务实、可行、能引发新发现且具有包容性(符合 USAID 2022 标准)。
  3. 方法 — 具体说明。
  4. 答案所支撑的决策 — 明确说明;指出答案将引导联邦网络作出的哪项决策。
  5. 使用计划 — 时间安排和材料形式;说明研究发现如何传达给决策者。
  6. 决策者 — 明确到角色级别(或适当时注明个人姓名)。
  7. 使用承诺 — 书面承诺,并设定门槛。
  8. 使用倡导者 — 指明具体人选。
  9. Tier — 明确标注(1 或 2)。
  10. 问题间的连贯性 — 如果该问题与正在构建的议程中的另一问题存在双向关联,请说明这种关联。
  11. 问题的证据基础 — 用一行说明该问题引用的 wiki 来源。
  12. 出处页脚 — 精简即可:用一段话列出设计简报、来源框架的 wiki 页面,以及任何基于推理的默认值标记。不要包含术语表、带注释的证据基础、执行摘要或阅读指南。

必需结构(Tier 2 片段):包括第 1–5 项、第 9 项、第 11 项和第 12 项;第 5 项改为“指示性用例”,第 9 项前须说明“为何属于 Tier 2”。

语气。 Tier 1 工作简报,采用默认语域。片段模式下不得加入面向初级 MEL 人员的教学内容(片段仅包含问题条目;教学内容应放在完整的 v1 文档中)。

片段模式的特定质量标准:

  • 每个 Tier 1 片段都必须包含 Patton 的全部三项锚点。缺少任何一项时,必须在文中标记 ⚠️ Tier 1 anchor incomplete — confirm or downgrade to Tier 2。未包含全部三项锚点却生成 Tier 1 片段,属于质量不合格。
  • 片段模式不生成术语表、执行摘要或带注释的证据基础。这些属于完整文档的内容;片段模式仅生成条目本身。
  • IPPF EN 背景真实度:试点 MA、决策者角色和预算框架须符合所提供的联邦网络背景。若将政策宽松的 MA 指定为限制性政策问题的试点地点,或提出与联邦网络 MEL 能力不匹配的预算范围,则该片段不予接受。
  • 如果源请求要求问题锚定到特定的 Researcher Evidence Brief 或其他材料,则“问题间的连贯性”一行必须明确引用该材料。

子提示词 — v2 — 季度 RAG 仪表板

默认长度。 1 页(约 600 字)。上限为 2 页,仅在品牌版式有此要求时适用。少于 400 字无法通过实质内容密度测试;超过 2 页则背离面向高级管理层的简洁原则。

必需结构(参照 learning-agenda-exemplar-v2.md):

  1. 标题栏 — 议程周期参考信息、期间(例如 Q2 2027)、日期、受众(高级管理层、MEL CoP、问题承诺负责人)、作者(PLI 高级顾问或具名角色)、篇幅、语气。
  2. 要点摘要 — 30 秒 BLUF:Tier 1 和 Tier 2 中绿色 / 琥珀色 / 红色状态的数量;影响最重大的琥珀色和红色状态;紧急行动。
  3. RAG 状态 — Tier 1 — 每个问题单独占一行的表格:# / 问题(简写)/ 方法 / Q[N] 状态(🟢 / 🟠 / 🔴)/ 一句话说明。
  4. RAG 状态 — Tier 2 — 结构与 Tier 1 相同。
  5. 本季度的变化 — 说明颜色变化的情况;解释每个红色和琥珀色状态。使用项目符号列表,不写段落。
  6. Tier 2 观察清单 — 新兴问题 — 下一次更新时可考虑提升优先级的问题。
  7. 考虑在更新时移除的 Tier 2 问题 — 可考虑删减的问题。可以为空(仪表板应将此空白记录为合理状态)。
  8. 下次仪表板发布前的行动事项 — 注明日期、明确责任人及有时限的后续行动。
  9. 证据基础 — 单行:USAID CLA Toolkit + agenda v1 路径。

语气。 Tier 1 工作简报,采用默认语域。不得加入面向初级 MEL 人员的教学内容。不得加入重点提示框。不得加入术语表。仪表板是供高级管理层使用的工作文档;教学内容由 agenda v1 承担。

v2 专属质量要求:

  • 默认版式严格控制为 1 页。仅在品牌版式的行距要求导致篇幅增加时,才允许 2 页。
  • 每个问题单独占一行的表格格式。RAG 颜色一目了然。每行用一句状态说明确保内容简洁。
  • 表格前先呈现要点摘要。遵循 BLUF 原则:用 3–4 句话说明数量、最重要事项和行动。
  • 观察清单和删减清单为必需栏目。缺少这两项,仪表板就只是状态报告,而不是用于在两次更新之间持续调整议程的决策工具。
  • 行动事项必须标明日期和具名责任人。否则仪表板只能提供信息,无法推动执行。
  • 默认采用 3 色 RAG(🟢 🟠 🔴)。部分 IPPF EN 工作规范使用 4 色,并以蓝色表示“已完成”;如果 Ane 提供了该规范,则切换为 4 色。
  • 仪表板不会修改 v1 议程,而是依据该议程报告状态。需要修改措辞或降低级别的问题,应在观察清单 / 删减清单中标记,并在下一次年度更新时处理。
  • 如果调用时未提供状态更新,技能将生成示例仪表板,并将所有状态标注为 ⚠️ Illustrative — confirm with question commitment-holders before circulation。

子提示词 — v3 — MA 适配模板

默认长度。 1,500–2,500 词(MA 议程的工作量低于联合会;联合会 v1 的长度为 5,000–7,000 词)。

默认问题数量。 4–8 个 MA 专属问题,加上 2–4 个联合会锚定条目。少于 4 个则不足以支撑一个 MA 周期;多于 8 个则超出 MA 层面的承载能力。

必需结构(参照 learning-agenda-exemplar-v3.md):

  1. 标题栏 — 标题(MA Learning Agenda <cycle>)、MA 名称、MA 周期(年度)、长度、语气、负责人(MA MEL Coordinator)、锚定的 v1 路径、刷新日期、周期中审查日期。
  2. MA 周期背景 — 一段文字,说明 MA 运营环境中正在发生哪些情况,这些情况如何影响 MA 本周期需要学习的内容。200–400 词。
  3. 锚定问题 — MA 参与回答或利用其答案的联合会 Tier 1 问题。每个条目包括:联合会问题参考、MA 的贡献、MA 的用途、MA 用途负责人。通常为 2–4 个条目。
  4. MA 专属学习问题 — Tier 1(带锚定)+ Tier 2(不带锚定)。结构与 v1 问题条目相同。通常为 3–5 个 MA 专属问题。
  5. 方法库与探究投入 — 表格:问题 / Tier / 方法 / 工作人员天数 / 直接成本。包括联合会锚定行(除参与外无增量成本)和 MA 专属行。包含总计行。包含联合会指导行,说明 MEL 职能人员探究投入时间目标为 8–12%(MA 议程的投入应控制在此范围内)。
  6. 审查节奏 — 每 6 个月进行一次 RAG 审查(比联合会的季度审查更轻量)+ 年度刷新 + 联合会协调(MA MEL Coordinator 作为 MA 代表参与联合会刷新)。
  7. 用途承诺 — 速查表 — 单一汇总表,列出所有问题对应的 MA 层面决策者、承诺和负责人。它是整个周期中 MA MEL Coordinator 使用频率最高的材料。
  8. 证据基础 — 一行引用 USAID + Britton + Patton + v1 议程路径。
  9. 本模板的编制方式 — 按照步骤 5 说明出处;特别注明 MA 模板由 MA 自行负责其议程,联合会不予批准。

语气。 Tier 1 工作简报,使用默认语体。不得加入面向初级 MEL 人员的教学内容。MA 已将联合会 v1 作为入门材料;MA 模板应保持精简。使用 MA 层面的语体:“ 承诺”“MA 的”,而非“联合会要求”。

v3 特有的质量标准:

  • 锚定部分必须位于 MA 专属部分之前。顺序体现原则:MA 先锚定,再根据自身情况调整。
  • 方法库应精简至符合 MA 的能力。技能应提出内部定性跟踪、焦点小组、轻量案头审查、人力资源记录、同伴互助等方法。技能不得在 MA 层面提出委托开展的多国评估。
  • 用途承诺应列出 MA 层面的决策者(MA Programmes Director、MA CSE technical lead、MA Roma coordinator),而非联合会职务。
  • 每 6 个月审查一次(通常为 5 月和 11 月),而非每季度一次。保持轻量,尊重 MA 的能力。
  • 必须提供用途承诺速查表。
  • 出处页脚须明确说明 MA 自主权:联合会不批准 MA 议程;遵循辅助性原则。
  • 如果 MA 名称不在当前 IPPF EN 联合会名单中,技能应标记 ⚠️ MA not recognised — confirm spelling and federation status。

引用要求

每份学习议程输出都会复用 wiki 框架页面中已核实的引用。强制规则:

  1. 引用来自 wiki 框架页面。 此技能参考 mel_wiki/wiki/frameworks/learning-agenda-usaid-cla-2022.md 和 utilisation-focused-knowledge-management.md。此技能不会引入新来源。需要引用的新框架应先交由 Li 和 wiki 处理,再纳入此技能。
  2. 格式。 作者姓氏 + 年份 + 发布平台 + 适用时注明章节。Junior-MEL register(v1)在正文中保留框架名称。Tier 1 default register(v2 + v3)则将引用移至 **Evidence base:** 行。
  3. 超链接。 复用 wiki 框架页面中已核实的 URL。wiki 中未收录的 URL,须标注 ⚠️ URL unverified — confirm before publication。
  4. 时效性。 wiki 框架页面会检查来源时效性。如果任一框架页面超过 12 个月,则此技能会在来源说明页脚中添加 ⚠️ Source framework page older than 12 months — verify still current 注释。

跨 MA 命名与候选删改协议

学习议程输出默认命名 MA,遵循已锁定的决策 11。 这不同于 learning-product 技能的默认设置(使用次区域标签)。原因:议程属于内部战略文件。点名 MA 能建立联合会信任,因为 MA 能看到自身工作得到呈现;议程只有在 MA 能从中看到自身时才最具公信力。

当正文中出现某个国家或具名 MA 时:

  • 来源说明页脚须包含 **Cross-MA references named:** 行,列出所有具名 MA。
  • 来源说明页脚须包含 **Redaction note:** 段落,说明内部使用时默认采用名称、外部使用时改用次区域标签的政策。
  • 如果在敏感风险议题上点名某个 MA(反性别议题引发的曝光、限制性环境下的员工留任、捐助方关系判断),则须在 **Redaction candidates:** 列表中标出,以便在任何外部使用前进行人工审核。

当用户指定 cross-MA naming convention = sub-region 时,此技能会改用次区域标签(Western Balkans MA、Caucasus MA、Baltic MA、Visegrád MA),并在来源说明页脚中注明这一替换。

品牌应用

每份成品都须通过 ane_package.reporting.brand.IPPF_FORMAT_TEMPLATE 应用 IPPF Visual Identity 2025。各格式的入口如下:

格式用途模块入口
Wordv1 默认;v3 默认;按要求提供 v2ane_package.reporting.word_export.write_word_report
PDFv2 默认;按要求提供 v1;v3 用于交接给 MAane_package.reporting.pdf_export.write_pdf_report
Markdown助手轮次中的所有输出类型(文本正文)

不得硬编码颜色、字体或格式。每次报告调用都从 IPPF_FORMAT_TEMPLATE 读取设置。Tier 2 出版标准例外情况(捐助方自有品牌、同行评审平台)须明确覆盖默认设置,并在文件中记录偏差。

写作规则

严格遵循 ~/.claude/CLAUDE.md 中的写作风格章节。使用主动语态。句子少于 25 个词。正文中不使用 em dash。不写填充语(“in order to”“it should be noted”)。能用动词表达时,不用名词化表达。避免抽象的开篇。不用反问句。先说重点。

只要不影响原意,优先使用盎格鲁-撒克逊词汇,而非拉丁语源词汇:用 not utilise,不用 utilise;用 start,不用 commence;用 help,不用 assist;用 check,不用 ascertain;用 run,不用 facilitate。

每份文件都须在首次出现时拼写出缩略语。首次使用时须写出 CSE = 综合性性教育,即使受众已熟悉该概念也不例外。

逐句进行可译性测试:以罗马尼亚语、突尼斯语、埃塞俄比亚语或越南语为母语的英语读者,能否首次阅读就理解?

局限性

此技能不会:

  • 生成用于回答议程第 1 级问题的底层 Researcher Evidence Briefs——这属于 researcher 技能,需按问题单独委托
  • 将答案整理成面向 MA 或捐赠方的简报——这属于 learning-product 技能,在 Researcher 之后运行
  • 举办年度更新研讨会——这属于召集工作;此技能产出召集活动所用的材料,而非召集活动本身
  • 跨周期跟踪使用情况——使用情况跟踪是第 B 级路线图项目(Li INGEST utilisation-tracking extension)
  • 取代 MA 对 MA 特定问题的判断——输出以第 1 级工作简报的形式起草,供 MA 编辑审阅;它们不是联合会指令
  • 决定是否对外发布——此决定需在审查待删改内容后提交给 Ane

Vi 专家注册

此技能也已在 agent-improvements/agent_registry.md 中注册为 Vi 专家 learning-agenda-designer。当任务简报要求在其他交付成果之外提供学习议程时,Vi 会启动该专家。该专家会阅读相同的范例和框架,并通过相同的路由器生成相同的三种输出类型。

编辑保留协议

如果 Ane 按路径引用现有输出,并要求改进、迭代或扩展该输出,则启用此协议。先读取文件,再使用 Edit 工具进行限定范围的编辑,确保范围外的内容逐字节保持不变,并返回 EDIT-PRESERVATION DELIVERY 摘要。

当目标文件存在时,应用 mel_wiki/wiki/concepts/edit-preservation-protocol.md。

评论

支持 Markdown