mcpField
L
learning-product

learning-product

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

关于 learning-product

learning-product 是一项技能,可将 Researcher Evidence Brief 转换为四种面向不同受众的学习产品。它保留原简报中的证据,并支持 MA 简报、工作坊资料包、区域学习简报及捐助方或管理备忘录。

主要功能

  1. 01四种基于证据的输出类型
  2. 02按受众和格式定制内容
  3. 03证据与引文忠实度检查
  4. 04URL 核验与来源说明

适用场景

  1. 01制作面向 MA 的学习简报
  2. 02编写工作坊或 CoP 资料包
  3. 03整理区域学习简报
  4. 04起草捐助方或管理备忘录

安装

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

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

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

详细介绍

学习产品

一份 Researcher 证据简报 → 四种学习产品输出类型之一。该技能将简报中的证据转化为受众可用的形式,同时不削弱严谨性,也不添加简报未核实的来源。

适用场景

遇到以下任一情况时触发:

  • “学习产品”“学习简报”“基于这份证据简报制作 MA 简报”“面向 MA 的简报”
  • “工作坊资料包”“CoP 资料包”“引导者资料包”“根据这份简报帮我设计一场工作坊”
  • “区域学习简报”“联合会简报”“区域综合分析”
  • “基于这份简报撰写捐助方备忘录”“管理层备忘录”“要点备忘录”“提交给捐助方的决策备忘录”
  • 明确指定输出类型(v1、v2、v3、v4、ma-brief、workshop-cop-pack、regional-learning-brief、donor-management-memo)

以下情况不要触发:

  • 编写基础的证据简报——这是 researcher 技能的任务
  • 编写并非基于 Researcher 证据简报的一般决策备忘录——这是 decision-memo 技能的任务
  • 设计评估或指标——这些属于其他独立技能
  • 构建 ToC——使用 toc-builder

必需输入

一次性询问。前两项为必填。

  1. 证据简报标识(必填):literature-reviews/ 下的目录名称,例如 2026-01-15_example-topic-region。该技能会读取 literature-reviews/<slug>/evidence-brief.md。
  2. 输出类型(必填):ma-brief(v1)、workshop-cop-pack(v2)、regional-learning-brief(v3)、donor-management-memo(v4)之一。
  3. 收件人(仅 v4 必填):donor-programme-officer、donor-senior、ippf-en-management、ippf-central-management、mp-or-policy 之一。用于校准语气和决策诉求的表述方式。
  4. 受众重点(可选):MA 集群、次区域、国家列表。默认值根据证据简报中的地理元数据确定。
  5. 篇幅调整(可选):超出默认篇幅的字数或页数。默认值见下文各输出类型的说明。
  6. 工作坊形式(可选,仅 v2):single-90min(默认)、two-session-split、half-day、full-day。影响幻灯片数量和环节时长。
  7. 工作坊模式(可选,仅 v2):in-person(默认)、hybrid、virtual。影响引导者备注和微观结构调整。
  8. 国家概况数量(可选,仅 v3):默认为 4;允许范围为 3–5。
  9. 国家命名惯例(可选,仅 v3):sub-region-label(默认——Western Balkans MA、Caucasus MA、Baltic MA、Visegrád MA)或 country-name(将触发候选删改标记)。
  10. 决策诉求(可选,仅 v4):收件人必须作出的具体决策。若未提供,该技能会起草占位内容,并标记为发布前需替换。

会话开始

  1. 完整阅读此 SKILL.md。
  2. 阅读 literature-reviews/<slug>/evidence-brief.md 中的证据简报。
  3. 阅读与所请求输出类型对应的范例:agent-improvements/learning-product-exemplar-v[1|2|3|4].md。该范例是结构目标。
  4. 如果上下文中尚未包含,阅读 ~/.claude/CLAUDE.md 中的受众层级语域部分;每次会话只需阅读一次。

工作流程

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

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

“请选择输出类型:ma-brief(2 页 MA 简报)、workshop-cop-pack(工作坊 + CoP 资料包)、regional-learning-brief(5–8 页联合会简报)或 donor-management-memo(1 页备忘录)?”

如果选择 donor-management-memo,但未提供 recipient 参数,则在同一轮中询问。

步骤 2 — 加载源材料

按顺序阅读:

  1. literature-reviews/<slug>/evidence-brief.md — 源内容
  2. literature-reviews/<slug>/sources.md(若存在)— 已核实的超链接列表
  3. literature-reviews/<slug>/literature-review.md(若存在)— 更完整的综合分析,适用于 v3 深度
  4. agent-improvements/learning-product-exemplar-v[N].md — 结构模板

Evidence Brief 的 frontmatter 包含输出标题区块所用的 region、period 和 confidence 元数据。

步骤 3 — 应用输出类型子提示词

根据下方四种子提示词之一进行路由。每种子提示词都会依据 Evidence Brief 的内容,套用相应模板的结构。

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

返回草稿前:

  • BLUF 原则。 第 1 句 = 结论。第 2 句 = 关键依据。v1 标题加粗且不超过 3 行;v3 执行摘要严格为 5 条要点;v4 底线为 1 段,并将决策请求加粗。
  • 语气。 默认采用 Tier 1 工作简报语气。v4 仅在提出决策请求的部分启用指令式语气。v2 引导者备注在程序性步骤中使用指令动词。
  • 引文位置。 Tier 1 工作简报:正文中不提框架名称;在章节末尾添加 **Evidence base:** 行。v2 来源幻灯片按照 feedback_source_slide_framing.md 中的要求,以“For further details you can consult:”作为引导语。
  • 引文严谨性。 适用时注明作者姓氏、年份、出版物名称和章节。内容必须直接取自 Evidence Brief。不得编造。
  • 超链接政策。 仅复用 Evidence Brief 或其 sources.md 中出现的 URL。不得编造。任何未出现在源材料中的 URL 都必须附上 ⚠️ URL unverified — confirm before publication。
  • 会话期间的 URL 审核步骤。 返回草稿前,按照 IPPF/UNFPA 超链接标准核验每个引用的 URL:
    • 聚合平台包装链接(consensus.app、ResearchGate、academia.edu、Wikipedia)必须替换为出版方规范 URL 或 DOI,方可发布。聚合平台链接仅可作为补充链接,与规范链接并列;不得作为唯一来源。
    • 指向付费墙的 DOI 链接必须补充开放获取版本(如 PMC、机构知识库、出版方托管的开放 PDF、作者手稿),若存在此类版本。
    • 迁移过的出版方 URL(例如 Rowman 迁至 Bloomsbury、期刊更换出版方等)必须更新为当前规范 URL。
    • 返回 404 的 URL 必须替换为规范永久链接(通常为 UNESDOC、DOI 或机构知识库)。
    • 如果规范来源没有开放获取版本,且受众为非学术读者,则引用中必须注明“付费墙限制,无开放获取版本”,以便 MA 工作人员和合作方读者提前知悉。 审计会在会话期间使用 WebFetch 和 WebSearch。将四种输出类型(v1/v2/v3/v4)的审计成本分摊到每份 Evidence Brief:每份只运行一次,缓存 URL 替换结果,并在基于同一份源简报生成的所有输出类型中重复使用。
  • 句子长度。 少于 25 个词。使用主动语态。正文中不使用破折号。能用动词时,不使用名词化表达。
  • 叙事文本模型 + 忠实度关卡(参见 agent-improvements/model-selection-policy.md)。示例性叙事内容——v1 小故事和 v2 CoP 工作坊情境——可以通过 Fable 的单次调用覆盖来起草(已获认可:对于受源材料约束的叙事文本,Fable 的起草更忠实,2026-06-10)。任何叙事内容若由 Fable 起草,都必须通过文本忠实度关卡(政策中的关卡 2):使用 Sonnet 对照源 Evidence Brief 运行检查,并在纳入内容前清除所有标记。v4 供资方/管理层谈话要点备忘录,以及任何说服性内容或管理决策内容,都必须使用本技能自身的模型(Opus/Sonnet)。此类内容不得使用 Fable,因为说服性文体会使两个模型都倾向于夸大陈述;无论如何,都要运行文本忠实度关卡,特别留意夸大陈述和归因膨胀。
  • 通俗英语。 优先使用盎格鲁-撒克逊词汇,少用拉丁词源词汇。缩略语首次出现时拼出全称。针对 ECA / SSA / MENA 读者进行可译性测试。
  • 默认进行分类呈现。 当 Evidence Brief 包含 WG-SS、年龄、性别认同或地理位置细分时,输出应保留这些细分,不得合并。
  • 跨 MA 命名。 默认使用次区域标签(Western Balkans MA、Caucasus MA、Baltic MA、Visegrád MA),除非 Evidence Brief 或 Ane 明确指出某个国家。使用国家级名称时,应标记为待删减内容。
  • IPPF Visual Identity 2025。 Word、PPTX 和 PDF 输出均须通过 ane_package.reporting 的品牌模板入口生成。不得硬编码颜色、字体或格式。
第 5 步——来源信息页脚

每项输出末尾都要包含一个 ## How this <product> was made 区块:

  • 用一段文字说明源 Evidence Brief(标识名 + 日期)、采用的语体以及品牌模板路径。
  • 添加一行 **Cross-MA references named:**,列出正文中提及的所有 MA 集群或国家。
  • 添加一个 **Redaction candidates:** 列表,列出联邦读者可能希望在对外使用前删除的任何具体 MA、国家或具名个人。如果正文只使用次区域标签,列表应写“none at sub-region level”。
  • 对于 v2/v3/v4,添加一行 **Companion artefacts in the four-exemplar series:**,交叉引用另外三项输出,路径格式为 agent-improvements/learning-product-exemplar-v[N].md。
第 6 步——返回

在助手轮次中以文本形式返回草稿。如果输出是工作坊资料包(v2),还要通过 ane_package.reporting 生成文件:

  • 幻灯片 → pptx_export.write_pptx_deck
  • 单页讲义 → word_export.write_word_report → 使用 pdf_export.write_pdf_report 导出为 PDF
  • 工作表 → 使用 word_export.write_word_report 生成简单的 Word 文件

对于 v1、v3、v4:在助手轮次中以 Markdown 正文形式返回。Ane 可酌情使用现有 reporting 模块将其转换为 Word/PDF/PPT。v3 篇幅足够长;如果 Ane 提出要求,也要使用 word_export.write_word_report 生成 Word 文档。


子提示词 — v1 — 面向 MA 的 2 页简报

默认长度。 1,200 个词(约 2 页)。上限为 1,500 个词。少于 1,000 个词则无法通过简报的实质内容密度测试。

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

  1. 标题区块 — 标题、受众、长度、日期、语气、证据(采用简报中的 Tier 1/2 混合)。
  2. 核心结论 — 3 行 BLUF,第 2 行的结论加粗。
  3. 本简报缘由 — 交代问题背景。3–5 句话。写明 Evidence Brief 中的地理区域。
  4. 已知情况 — 3–5 项编号发现。每项发现为一段。发现须逐字引用或压缩自 Evidence Brief 的 RQ1 / Findings 部分。
  5. 证据基础行 — 放在“已知情况”末尾。添加超链接。取自简报的来源列表。
  6. MA 可用的四种杠杆 — 3–4 种杠杆。每种杠杆包括:行动(1 句话)、为何有效(1 段)、一个 MA 示例(1 个短段落;默认使用次级区域标签)、资源估算(1 行)。只有当 Evidence Brief 未提供相关内容时,才可略去某个子项。
  7. 下个季度要做什么 — 一项具体行动。要求承诺采用一种杠杆。
  8. 针对你的情境提出的调整问题 — 4 个问题。问题应邀请 MA 作出判断,而非由秘书处发出指示。
  9. 带到下一次区域同行交流会的问题 — 4 个问题,为 CoP 会议作铺垫。
  10. 本简报的编制方式 — 来源说明 + 按照步骤 5 列出的候选删减内容。

语气。 Tier 1 工作简报,协作式。“我们建议”“你的 MA 可以”“证据表明”“各 MA 可根据情境调整”。仅在涉及合规要求的内容中使用指令式语气——v1 中没有此类内容。

v1 专属质量要求:

  • 调整提示必须是问题,不得写成陈述。
  • 每种杠杆都必须附带一段“为何有效”;缺少这一部分会使简报达不到 USAID 面向实施者的学习简报标准。
  • “下个季度要做什么”部分必须要求承诺采用一种杠杆,而不能提供多种杠杆供选择。
  • 如果来源 Evidence Brief 中包含针对各项发现的置信度标记(HIGH / MODERATE / LOW / MIXED),须在“已知情况”部分中将其保留在各项发现旁。Federation 读者需要了解置信度差异,才能解读杠杆选择;将其归并为单一评级会掩盖这些差异。

子提示词 — v2 — 工作坊 / CoP 套件

默认设置。 单场 90 分钟;8–15 名参与者;线下形式;完整套件(幻灯片 + 引导者备注 + 讲义 + 工作表 + 会前阅读材料 + 会后提示词)。

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

  1. 套件元数据块 — 工作坊标题、范围、受众、时长、形式、日期、语气、源简报、CoP 培育框架。
  2. 会前材料 — 会前阅读材料(如果存在,则使用 v1 简报;否则使用证据简报的执行摘要);会前诊断(4 个问题);引导者简报(1 页)。
  3. 幻灯片 — 默认设置下 14 张,结构如下:封面(1)→ BLUF 和诊断反馈(2–3)→ 研究结果(4–7)→ 使用 1-2-4-All 或同等解放结构微型流程的小组工作环节(8)→ 杠杆(9–12)→ 使用工作表的双人活动(13)→ 全体承诺(14)→ 来源(15)。允许上下浮动 1 张;不得少于 12 张或多于 17 张。每张幻灯片都包含:内容、引导者备注(时间 + 要做什么 + 要引导出什么 + 注意事项),以及适用时的混合式 / 虚拟形式调整。
  4. 单页讲义 — A 面:以 4 行表格列出 4 项研究结果;B 面:以 4 行表格列出 4 个杠杆,并附结尾问题。
  5. 工作表 — 单页:选定的杠杆、为什么这个杠杆适用于你的情境、前 30 天的逐周计划、你需要联合会提供什么、如何判断是否奏效。
  6. 会后材料 — 48 小时邮件(承诺表格 + 问题列表 + CoP 培育框架);第 6 周同伴交流提示词(2 个问题);引导者 AAR(4 个问题,仅供引导者使用)。
  7. 混合式和虚拟形式调整 — 按微型流程内嵌备注。
  8. 材料清单 — 适用于线下活动。
  9. 本套件的制作方式 — 按步骤 5 说明来源信息 + 可删减内容候选项。

语气。 Tier 1 工作简报在幻灯片内容中始终采用协作式语气。引导者备注使用祈使动词说明流程步骤(“大声读出 BLUF。停顿。提问……”)——这是流程用语,并非语域切换。

v2 专属质量标准:

  • 小组环节必须包含 1-2-4-All 微型流程(Lipmanowicz & McCandless 2013)或同等的解放结构方法。不得只说“结对讨论”而不提供结构。
  • 每张幻灯片都必须附带逐页引导者备注。只有确实没有任何需要留意的情况(极少见)才可省略“注意事项”。
  • 会后材料是套件的组成部分,不可选。缺少这些材料的套件只是工作坊,而不是 CoP 培育套件。
  • 第 15 张来源幻灯片使用“For further details you can consult:”,不得只写“Source:”;投影时正文字号 ≥20pt。
  • 必须明确说明 CoP 培育框架:本次工作坊是一个正在建设中的 CoP 的首次聚会;承诺和工作表是首次实践产出。
  • 如果源证据简报包含超过 4 项研究结果,则在幻灯片中(第 4–7 张)删去置信度为 LOW 和 LOW–MODERATE 的研究结果;在讲义的证据依据和来源幻灯片中保留。幻灯片中保留 4 张研究结果页;讲义用于容纳超出的内容。
  • 如果当前会话中无法使用 ane_package.reporting.pptx_export(技能在工作文件夹之外运行,或未安装 ane_package),则改用 Markdown 幻灯片规格——逐页列出内容 + 引导者备注——并指示 Ane 在工作文件夹中运行 PPTX 生成。优先使用 PPTX,但并非必需。
  • 可选参数 cop-state(默认为 building / established)用于控制 CoP 框架。building 使用“正在建设中的 CoP 首次聚会”;established 使用“[N]th convening of the [name] CoP”,其中 N 和 name 在调用时传入。

品牌应用。 幻灯片通过 pptx_export.write_pptx_deck 生成;讲义通过 word_export.write_word_report → PDF 生成;工作表通过 word_export.write_word_report 生成。Power BI / Tableau 导出不适用。


子提示词 — v3 — 区域学习简报

**默认篇幅。**3,000–5,000 字(约 5–8 页);默认目标为 6 页(约 3,200 字)。

**默认国家概况数量。**4 个;范围为 3–5 个。

**默认命名惯例。**次区域标签。

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

  1. 标题区块——标题、受众(全联合会范围的 MEL 从业者、高级领导层、捐助方项目官员、政策研究人员)、篇幅、日期、文风、来源简报。

  2. 如何阅读本简报——v3 的默认章节,置于标题区块与执行摘要之间。分为两部分:

    • 语言说明子段落,列出简报中使用的缩略词,并提示读者查看接近文末的术语表。
    • 置信度说明子段落,定义简报中出现的每个置信度标签,并用一句话说明评级依据。依据为来源《研究人员证据简报》,该简报采用标准的证据综合规范。评级取决于研究类型、独立来源的数量、不同研究之间的一致性,以及与问题的直接相关性。该方法类似于健康研究中的 GRADE,并针对 CSE / SRHR 评估中常见的混合证据基础做了调整。

    置信度标签的默认内容(v3 输出中原文保留;将方括号中的领域主题替换为相应内容):

    • **我们对这一发现有信心。**多项独立开展的同行评审研究得出了相同结论。证据相互印证。
    • **我们对这一发现比较有信心。**这一发现符合我们对 [领域主题] 运作方式的既有认识。针对我们所在地区(或这一具体方法)的评估有限。从业者经验表明该方法有效。已发表的比较数据尚未达到捐助方或外部读者通常期望的水平。
    • **信心较低——证据仍在形成。**有理论或机制层面的理由认为该方法有效,但运营层面的评估尚未直接检验这一点。应将其视为有潜力的方法,而非已获证实的方法。
    • **信心水平不一——因方法而异。**本条目中的研究结果处于不同置信度水平。简报正文会保留这些差异。
  3. 执行摘要——恰好 5 条要点。要点应体现区域模式,而不只是重述研究发现。

  4. 本简报的缘由——2–3 个段落。须包含 CoP 培育的框架性表述(简报本身就是一种 CoP 实践成果)。

  5. 区域概况——3 个子标题,点明构成分析背景的结构性变化(例如,针对某一区域:政策转变、资金转变、可用数据的变化)。每项变化均须逐字引用《证据简报》中的来源。

  6. 四项发现及跨 MA 证据——摘自《证据简报》的 RQ1 发现;每项发现都须添加一句“跨 MA 证据”,说明次区域模式。末尾以 **证据基础:** 行收尾。

  7. 国家概况——N 个 MA 背景——每个概况均采用固定子结构:背景(1 段)→ 应用的杠杆(1 行)→ 有效做法(2–3 条要点)→ 无效做法(1–2 条要点)→ 经验教训(1 句话)。只有在《证据简报》未涵盖某一项时,才可省略该项。

  8. 跨领域策略——各概况的共同点——体现简报的分析贡献。指出各概况之间的模式(例如,杠杆与现有关系资本相匹配)。包含一个段落和一个简短列表。相较于 v1,这一章节是区域简报发挥价值的关键。

  9. 按 MA 模式提出的调整建议——3 种模式,各自对应不同的杠杆建议。每种模式都须提出一个诊断问题。末尾须为不符合这三种模式中任何一种的 MA 提供备选路径。

  10. 这对联合会意味着什么——最多 3 项行动。仅在此处提及联合会基础设施。

  11. 来源——列出简报来源清单中的完整证据基础。

  12. 本简报的编写过程——按照步骤 5,说明来源溯源信息 + 拟删节内容 + 配套成果。 语气。 Tier 1 工作简报,采用全联合会协作式语气。区域简报面向联合会各地的 MEL 从业者和高级领导层;语气应体现联合会由 MA 主导的架构,而非宣称秘书处拥有权威。

v3 特有的质量标准:

  • 执行摘要始终严格包含 5 条要点。联合会领导层只阅读这些要点。
  • 国家概览采用固定的子结构。概览篇幅存在差异即属质量问题。
  • 跨领域策略部分必须揭示各概览之间的共同模式,而非重述调查结果。
  • 适应性提示必须是诊断性问题,而非指令。
  • 联合会行动最多 3 项。4 项会分散注意力。
  • 默认使用次区域标签;任何国家级名称都必须明确标记为候选删减内容。
  • 如果来源证据简报包含调查结果级别的置信度标记,必须在「具有跨 MA 证据的四项调查结果」中,将其保留在各项调查结果旁。同 v1 要求。
  • 如果来源证据简报包含 3 项或以上的数据缺口条目,请根据简报中的数据缺口清单,添加「我们不知道什么」部分,作为第十一个结构元素,置于「这对联合会意味着什么」与「来源」之间。联合会受众应能在了解调查结果的同时看到证据的局限;隐去这些局限,会把发现缺口的工作转嫁给捐助方或外部读者。
  • 保留来源简报中区域标签的确切形式。如果简报使用「Visegrád / Central Europe」,首次出现时必须保留两种标签,不得直接简化为「Visegrád MA」。

子提示词 — v4 — 捐助方/管理层谈话要点备忘录

默认长度。 900 词(约 1 页)。硬性上限为 1,500 词。超过 1,500 词时:拆分为两份备忘录,或改用 v3(区域学习简报)。

所需结构(参照 learning-product-exemplar-v4.md):

  1. 标题区块 — 标题、受众(注明接收者职务)、长度、日期、语气、来源,以及置于顶部的所需决策。
  2. 核心结论 — 1 段。将所需决策加粗。提供可用于决策的摘要;读者可在 30 秒后停止阅读。
  3. 三个谈话要点 — 恰好三个。每个谈话要点为 1–2 段,且可用于口头简报。谈话要点取自证据简报中的 RQ1/RQ2/RQ3 发现。
  4. 预期问题 — 3–5 组问答。预先回答接收者最可能提出的问题。
  5. 所需决策 — 编号列出,内容具体。每项都是要求接收者作出的一项明确决策。不得提出含糊的请求。
  6. 来源 — 简短列表。使用引导语“For further details you can consult:”。从证据简报的来源中选取。
  7. 本备忘录的编制方式 — 溯源信息 + 必要时标注接收者占位符 + 根据步骤 5 列出配套材料。

语气。 从谈话要点部分开始,采用第 1 级工作简报语气。根据 ~/.claude/CLAUDE.md 的受众层级语气规范,仅在“所需决策”部分启用指示性语气:“我们请求”“我们寻求批准”“我们请[接收者]授权”。

v4 特有的质量标准:

  • 核心结论必须恰好为 1 段;所需决策需加粗。不得出现两个核心结论。
  • 谈话要点必须恰好为三个。四个会冲淡重点;两个则显得内容单薄。
  • 除非 Ane 明确豁免,否则必须设置预期问题部分。
  • 所需决策必须编号列出且内容具体。含糊的请求(例如“希望您考虑一下”)不符合质量要求。
  • 仅在“所需决策”部分启用指示性语气。谈话要点应保持协作语气。混用会导致语气不协调。
  • 调用时必须提供接收者参数;否则无法校准语气。
  • 如果源证据简报中的任何发现为 MIXED 或 LOW,预期问题部分必须明确说明证据局限。捐助方尽职调查无论如何都会发现这些局限;提前作答有助于建立可信度。

接收者语气校准:

接收者语气细微差异所需决策的表述方式
donor-programme-officer注重运营;假定其熟悉项目机制“按当前水平继续资助”;“批准增量新增事项”;明确预算范围
donor-senior注重战略;论证聚焦整体模式“认可该框架”;“表明多年期意向”
ippf-en-management尊重联合会;明确体现对成员协会优先事项的平衡“秘书处能力”;“召集协调职能”;“基础设施”
ippf-central-management聚焦联合会整体模式;明确体现与 Vision 2030/Strategic Framework 的一致性“跨区域适用性”;“可供调整的模式”;“联合会学习架构”
mp-or-policy公共政策语气;明确体现权利框架“尊重权利的政策”;“基于证据的立法立场”

引用要求

每个学习产品都复用《证据简报》中已核实的引用。必须遵守以下规则:

  1. 引用只能来自《证据简报》或其 sources.md。仅此而已。 技能不得添加来源中没有的新引用。如果存在比简报所用来源更有力的来源,应将这一缺口交回 Researcher,而不是写入学习产品。
  2. 格式。 作者姓氏 + 年份 + 发表平台;适用时注明章节。Tier 1 工作简报将引用移至章节末尾的 **Evidence base:** 行。
  3. 超链接。 复用《证据简报》中已核实的 URL。若来源中没有某个 URL,则标注 ⚠️ URL unverified — confirm before publication。
  4. 时效性。 《证据简报》在制作时确保内容具有时效性;学习产品沿用这一要求。如果《证据简报》的日期早于 12 个月前,技能会在溯源页脚标记 ⚠️ Source brief is older than 12 months — confirm currency before external use。
  5. 相互冲突的来源。 如果《证据简报》标记了 Tier 1 来源之间存在 ⚠️ CONFLICT:,则在学习产品中保留此标记,不得掩盖冲突。
  6. 数据缺口。 如果《证据简报》标记了 ⚠️ Data gap:,则在学习产品中以相同格式保留该缺口,并在正文相应位置标出。不得省略。

跨 MA 命名与候选删改内容规范

联邦信任的默认做法:除非《证据简报》或 Ane 明确指出某个国家,否则应以次区域集群层级命名 MA 工作(Western Balkans MA、Caucasus MA、Baltic MA、Visegrád MA)。

正文中出现国家或具名个人时:

  • 在溯源页脚末尾添加 **Redaction candidates:** 列表。
  • 每项候选删改内容都应说明未经核查就对外发布时面临的具体风险(敏感内容涉及的 MA、具名个人或具名试点地点)。
  • Ane 在对外使用前需手动审核此列表。

正文仅使用次区域标签时,列表应写作 **Redaction candidates:** none at sub-region level。

品牌应用

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

格式用途模块调用入口
Wordv3 默认;收件人为管理层时用 v4;按要求使用 v1ane_package.reporting.word_export.write_word_report
PowerPointv2 幻灯片ane_package.reporting.pptx_export.write_pptx_deck
PDFv2 讲义;收件人为捐助方时用 v4;按要求使用 v3ane_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(facilitate 用作工作坊角色名称时除外)。

每份文档都应在首次出现时拼写出首字母缩略词。即使读者已经了解,CSE 首次出现时也必须写作 Comprehensive Sexuality Education。

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

局限性

此技能不会:

  • 生成底层的 Evidence Brief — 这属于 researcher 技能的职责
  • 在会话期间验证超链接 — 这属于 Researcher 在制作简报时的职责。此技能仅重用已验证的 URL。
  • 生成图表、信息图或视频 — 这些属于独立工作流
  • 编造 Evidence Brief 中未提及的跨 MA 案例、具名个人或具体试点地点
  • 决定是否对外发布输出 — 此决定由 Ane 在审查待脱敏内容后作出
  • 取代由 MA 主导的调整。输出以 Tier 1 工作简报的形式起草,供 MA 判断;它们不是联合会指令。

Vi 专家注册

此技能还以 Vi 专家 learning-product-designer 的身份注册在 agent-improvements/agent_registry.md 中。当任务简报要求在其他交付成果之外提供学习产品时,Vi 会调用该专家。该专家读取同一 Evidence Brief slug,并通过同一路由器生成相同的四种输出类型。

编辑保留协议

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

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

评论

支持 Markdown