关于 learning-agenda
learning-agenda 是用于编写联合会学习议程、季度 RAG 仪表板或成员协会适配模板的技能。它按问题层级、使用锚点、来源规则和各输出类型的结构要求组织内容。
主要功能
- 01提供议程、仪表板和模板三种输出
- 02支持单个问题条目模式
- 03按层级设置问题与使用锚点
- 04规定来源和引用要求
- 05添加来源说明与命名备注
适用场景
- 01起草年度联合会学习议程
- 02编制季度议程状态仪表板
- 03为成员协会调整议程
- 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-argyriswiki 页面运行的evidence-synthesis技能 - 项目 M&E 计划、成果框架、指标集——这些属于单独的技能
- 用于回答学习议程问题的 Researcher Evidence Brief——这属于
researcher技能
必需输入
请一次性询问以下输入。标记为必需的输入在调用时必须提供;标记为可选的输入使用默认值。
- 输出类型(必需):以下之一:
canonical(v1,完整联邦议程)、fragment(单个问题条目——v1 的一种子模式,生成一个 Tier 1 或 Tier 2 问题条目,不包含完整文档框架;用于验证、对候选问题进行同行评审或迭代构建议程)、rag-dashboard(v2)、ma-template(v3)。 - 周期名称(必需):例如
2027、FY2027-28、2026-2028 biennium。用于标题区块和更新频率。 - 联邦战略背景(v1 必需;v2/v3 可选):一段文字,或指向战略计划更新文档的路径,其中列出影响该周期的战略压力。
- 问题列表(v1 可选):如果 Ane 提供学习问题列表及拟定的 Tier 1/Tier 2 分类,该技能会按议程格式整理这些问题。如果未提供,该技能会根据战略背景起草示例问题,并为每个问题标注
⚠️ Reasoned default — confirm with federation MEL function。 - 已锚定的 v1 路径(v2 + v3 必需):v2 或 v3 所引用的标准议程文件路径。默认值:
agent-improvements/learning-agenda-exemplar-v1.md(技能验证用示例);实际使用时,应填写当前周期标准议程的路径。 - 时期(仅 v2 必需):例如
Q2 2027。用于仪表板标题区块。 - 状态更新(v2 可选):每个问题的 RAG 状态 + 一行说明。如果未提供,该技能会生成示例状态并标注为示例。
- MA 名称(v3 必需):IPPF EN 会员协会名称(例如
IPPF <Country> (<acronym>)、IPPF Albania)。 - MA 战略背景(v3 必需):一段文字,说明影响 MA 议程的运营背景。
- MA 问题列表(v3 可选):MA 特定问题;如果未提供,该技能会根据战略背景起草问题,并标注为基于推理的默认内容。
- 跨 MA 命名约定(所有输出类型均可选):
name(锁定决策 11 中的默认值)或sub-region(脱敏回退方案)。使用国家级名称时,来源信息页脚会标记为候选脱敏项。
会话开始
- 完整阅读此 SKILL.md。
- 阅读与所请求输出类型对应的范例:
agent-improvements/learning-agenda-exemplar-v[1|2|3].md。范例是结构参照。 - 如果尚未在当前会话上下文中阅读过,请阅读框架基础文档
mel_wiki/wiki/frameworks/learning-agenda-usaid-cla-2022.md和mel_wiki/wiki/frameworks/utilisation-focused-knowledge-management.md。 - 如果尚未在当前会话上下文中阅读过,请阅读
~/.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 — 加载源材料
按以下顺序阅读:
agent-improvements/learning-agenda-exemplar-v[N].md— 所请求输出的结构参照。mel_wiki/wiki/frameworks/learning-agenda-usaid-cla-2022.md— 框架基础;USAID 四要素模板与 Patton 三锚点扩展定义。mel_wiki/wiki/frameworks/utilisation-focused-knowledge-management.md— 使用锚定的操作原则。- 对于 v2 和 v3:提供的 v1 路径。
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):
- 标题栏 — 标题、受众(联合会 MEL 职能部门 + 高级管理层 + MEL CoP + 所有活跃 MA 的 MEL 负责人 + 新入职 MEL 人员)、周期、篇幅、文风(一级工作简报、面向初级 MEL 人员的语体)、更新日期、季度 RAG 时间表。
- 执行摘要 — 2 分钟可读完。一级 / 二级问题数量;与上一周期相比的前三项变化;指定一名统筹各问题的使用推动者。
- 如何阅读本议程 — 面向初级 MEL 人员的教学性补充内容。列出六个部分;解释选择初级 MEL 人员语体的原因;使用一个
**为何重要**提示框。 - 周期背景与设计选择 — 战略框架;A+C 混合方案的理由;一个
**常见误区**提示框;一行以初级 MEL 人员语体风格标注的**设计依据**。 - 十二个学习问题 — 先列一级问题(7 个),再列二级问题(5 个)。每个一级问题均包含:问题;方法;答案将支持的决策;使用计划;决策者;使用承诺;使用推动者;级别(= 1);另附行内
**问题依据**。至少有一个一级问题包含**示例 — 如何解读一级问题**提示框(用于初级 MEL 教学)。每个二级问题均包含:问题;方法;示例性使用场景;为何列为二级;级别(= 2);另附行内**问题依据**。 - 探究投入摘要 — 表格:问题 / 级别 / 方法 / 人员天数 / 直接成本。包含合计行。包含一级 / 二级拆分行,体现投入分配原则(一级问题占人员天数的 60–80%)。使用一个
**常见误区**提示框说明该原则。 - 审查检查点 — 季度 RAG(轻量级、一页格式,指向 v2 示例)+ 年度更新(Britton AAR 方法)。至少有一个
**示例 — AAR 开篇是什么样的**提示框(用于初级 MEL 教学)。 - 本议程的编制方式 — 按照步骤 5 说明来源信息 + 脱敏说明。
- 术语表 — 面向初级 MEL 人员的语体要求。列出议程中使用的 12–18 个 MEL 术语,每个术语用 1–2 行通俗英语解释。
- 带注释的证据基础 — 面向初级 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 片段):
- Tier 和问题标签 — 例如 “TIER 1 — Q1(片段)” 或 “TIER 1 — 单问题条目”。
- 问题 — 聚焦、务实、可行、能引发新发现且具有包容性(符合 USAID 2022 标准)。
- 方法 — 具体说明。
- 答案所支撑的决策 — 明确说明;指出答案将引导联邦网络作出的哪项决策。
- 使用计划 — 时间安排和材料形式;说明研究发现如何传达给决策者。
- 决策者 — 明确到角色级别(或适当时注明个人姓名)。
- 使用承诺 — 书面承诺,并设定门槛。
- 使用倡导者 — 指明具体人选。
- Tier — 明确标注(
1或2)。 - 问题间的连贯性 — 如果该问题与正在构建的议程中的另一问题存在双向关联,请说明这种关联。
- 问题的证据基础 — 用一行说明该问题引用的 wiki 来源。
- 出处页脚 — 精简即可:用一段话列出设计简报、来源框架的 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):
- 标题栏 — 议程周期参考信息、期间(例如 Q2 2027)、日期、受众(高级管理层、MEL CoP、问题承诺负责人)、作者(PLI 高级顾问或具名角色)、篇幅、语气。
- 要点摘要 — 30 秒 BLUF:Tier 1 和 Tier 2 中绿色 / 琥珀色 / 红色状态的数量;影响最重大的琥珀色和红色状态;紧急行动。
- RAG 状态 — Tier 1 — 每个问题单独占一行的表格:# / 问题(简写)/ 方法 / Q[N] 状态(🟢 / 🟠 / 🔴)/ 一句话说明。
- RAG 状态 — Tier 2 — 结构与 Tier 1 相同。
- 本季度的变化 — 说明颜色变化的情况;解释每个红色和琥珀色状态。使用项目符号列表,不写段落。
- Tier 2 观察清单 — 新兴问题 — 下一次更新时可考虑提升优先级的问题。
- 考虑在更新时移除的 Tier 2 问题 — 可考虑删减的问题。可以为空(仪表板应将此空白记录为合理状态)。
- 下次仪表板发布前的行动事项 — 注明日期、明确责任人及有时限的后续行动。
- 证据基础 — 单行: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):
- 标题栏 — 标题(
MA Learning Agenda <cycle>)、MA 名称、MA 周期(年度)、长度、语气、负责人(MA MEL Coordinator)、锚定的 v1 路径、刷新日期、周期中审查日期。 - MA 周期背景 — 一段文字,说明 MA 运营环境中正在发生哪些情况,这些情况如何影响 MA 本周期需要学习的内容。200–400 词。
- 锚定问题 — MA 参与回答或利用其答案的联合会 Tier 1 问题。每个条目包括:联合会问题参考、MA 的贡献、MA 的用途、MA 用途负责人。通常为 2–4 个条目。
- MA 专属学习问题 — Tier 1(带锚定)+ Tier 2(不带锚定)。结构与 v1 问题条目相同。通常为 3–5 个 MA 专属问题。
- 方法库与探究投入 — 表格:问题 / Tier / 方法 / 工作人员天数 / 直接成本。包括联合会锚定行(除参与外无增量成本)和 MA 专属行。包含总计行。包含联合会指导行,说明 MEL 职能人员探究投入时间目标为 8–12%(MA 议程的投入应控制在此范围内)。
- 审查节奏 — 每 6 个月进行一次 RAG 审查(比联合会的季度审查更轻量)+ 年度刷新 + 联合会协调(MA MEL Coordinator 作为 MA 代表参与联合会刷新)。
- 用途承诺 — 速查表 — 单一汇总表,列出所有问题对应的 MA 层面决策者、承诺和负责人。它是整个周期中 MA MEL Coordinator 使用频率最高的材料。
- 证据基础 — 一行引用 USAID + Britton + Patton + v1 议程路径。
- 本模板的编制方式 — 按照步骤 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 框架页面中已核实的引用。强制规则:
- 引用来自 wiki 框架页面。 此技能参考
mel_wiki/wiki/frameworks/learning-agenda-usaid-cla-2022.md和utilisation-focused-knowledge-management.md。此技能不会引入新来源。需要引用的新框架应先交由 Li 和 wiki 处理,再纳入此技能。 - 格式。 作者姓氏 + 年份 + 发布平台 + 适用时注明章节。Junior-MEL register(v1)在正文中保留框架名称。Tier 1 default register(v2 + v3)则将引用移至
**Evidence base:**行。 - 超链接。 复用 wiki 框架页面中已核实的 URL。wiki 中未收录的 URL,须标注
⚠️ URL unverified — confirm before publication。 - 时效性。 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。各格式的入口如下:
| 格式 | 用途 | 模块入口 |
|---|---|---|
| Word | v1 默认;v3 默认;按要求提供 v2 | ane_package.reporting.word_export.write_word_report |
| v2 默认;按要求提供 v1;v3 用于交接给 MA | ane_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。