关于 learning-product
learning-product 是一项技能,可将 Researcher Evidence Brief 转换为四种面向不同受众的学习产品。它保留原简报中的证据,并支持 MA 简报、工作坊资料包、区域学习简报及捐助方或管理备忘录。
主要功能
- 01四种基于证据的输出类型
- 02按受众和格式定制内容
- 03证据与引文忠实度检查
- 04URL 核验与来源说明
适用场景
- 01制作面向 MA 的学习简报
- 02编写工作坊或 CoP 资料包
- 03整理区域学习简报
- 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
必需输入
一次性询问。前两项为必填。
- 证据简报标识(必填):
literature-reviews/下的目录名称,例如2026-01-15_example-topic-region。该技能会读取literature-reviews/<slug>/evidence-brief.md。 - 输出类型(必填):
ma-brief(v1)、workshop-cop-pack(v2)、regional-learning-brief(v3)、donor-management-memo(v4)之一。 - 收件人(仅 v4 必填):
donor-programme-officer、donor-senior、ippf-en-management、ippf-central-management、mp-or-policy之一。用于校准语气和决策诉求的表述方式。 - 受众重点(可选):MA 集群、次区域、国家列表。默认值根据证据简报中的地理元数据确定。
- 篇幅调整(可选):超出默认篇幅的字数或页数。默认值见下文各输出类型的说明。
- 工作坊形式(可选,仅 v2):
single-90min(默认)、two-session-split、half-day、full-day。影响幻灯片数量和环节时长。 - 工作坊模式(可选,仅 v2):
in-person(默认)、hybrid、virtual。影响引导者备注和微观结构调整。 - 国家概况数量(可选,仅 v3):默认为 4;允许范围为 3–5。
- 国家命名惯例(可选,仅 v3):
sub-region-label(默认——Western Balkans MA、Caucasus MA、Baltic MA、Visegrád MA)或country-name(将触发候选删改标记)。 - 决策诉求(可选,仅 v4):收件人必须作出的具体决策。若未提供,该技能会起草占位内容,并标记为发布前需替换。
会话开始
- 完整阅读此 SKILL.md。
- 阅读
literature-reviews/<slug>/evidence-brief.md中的证据简报。 - 阅读与所请求输出类型对应的范例:
agent-improvements/learning-product-exemplar-v[1|2|3|4].md。该范例是结构目标。 - 如果上下文中尚未包含,阅读
~/.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 — 加载源材料
按顺序阅读:
literature-reviews/<slug>/evidence-brief.md— 源内容literature-reviews/<slug>/sources.md(若存在)— 已核实的超链接列表literature-reviews/<slug>/literature-review.md(若存在)— 更完整的综合分析,适用于 v3 深度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):
- 标题区块 — 标题、受众、长度、日期、语气、证据(采用简报中的 Tier 1/2 混合)。
- 核心结论 — 3 行 BLUF,第 2 行的结论加粗。
- 本简报缘由 — 交代问题背景。3–5 句话。写明 Evidence Brief 中的地理区域。
- 已知情况 — 3–5 项编号发现。每项发现为一段。发现须逐字引用或压缩自 Evidence Brief 的 RQ1 / Findings 部分。
- 证据基础行 — 放在“已知情况”末尾。添加超链接。取自简报的来源列表。
- MA 可用的四种杠杆 — 3–4 种杠杆。每种杠杆包括:行动(1 句话)、为何有效(1 段)、一个 MA 示例(1 个短段落;默认使用次级区域标签)、资源估算(1 行)。只有当 Evidence Brief 未提供相关内容时,才可略去某个子项。
- 下个季度要做什么 — 一项具体行动。要求承诺采用一种杠杆。
- 针对你的情境提出的调整问题 — 4 个问题。问题应邀请 MA 作出判断,而非由秘书处发出指示。
- 带到下一次区域同行交流会的问题 — 4 个问题,为 CoP 会议作铺垫。
- 本简报的编制方式 — 来源说明 + 按照步骤 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):
- 套件元数据块 — 工作坊标题、范围、受众、时长、形式、日期、语气、源简报、CoP 培育框架。
- 会前材料 — 会前阅读材料(如果存在,则使用 v1 简报;否则使用证据简报的执行摘要);会前诊断(4 个问题);引导者简报(1 页)。
- 幻灯片 — 默认设置下 14 张,结构如下:封面(1)→ BLUF 和诊断反馈(2–3)→ 研究结果(4–7)→ 使用 1-2-4-All 或同等解放结构微型流程的小组工作环节(8)→ 杠杆(9–12)→ 使用工作表的双人活动(13)→ 全体承诺(14)→ 来源(15)。允许上下浮动 1 张;不得少于 12 张或多于 17 张。每张幻灯片都包含:内容、引导者备注(时间 + 要做什么 + 要引导出什么 + 注意事项),以及适用时的混合式 / 虚拟形式调整。
- 单页讲义 — A 面:以 4 行表格列出 4 项研究结果;B 面:以 4 行表格列出 4 个杠杆,并附结尾问题。
- 工作表 — 单页:选定的杠杆、为什么这个杠杆适用于你的情境、前 30 天的逐周计划、你需要联合会提供什么、如何判断是否奏效。
- 会后材料 — 48 小时邮件(承诺表格 + 问题列表 + CoP 培育框架);第 6 周同伴交流提示词(2 个问题);引导者 AAR(4 个问题,仅供引导者使用)。
- 混合式和虚拟形式调整 — 按微型流程内嵌备注。
- 材料清单 — 适用于线下活动。
- 本套件的制作方式 — 按步骤 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):
-
标题区块——标题、受众(全联合会范围的 MEL 从业者、高级领导层、捐助方项目官员、政策研究人员)、篇幅、日期、文风、来源简报。
-
如何阅读本简报——v3 的默认章节,置于标题区块与执行摘要之间。分为两部分:
- 语言说明子段落,列出简报中使用的缩略词,并提示读者查看接近文末的术语表。
- 置信度说明子段落,定义简报中出现的每个置信度标签,并用一句话说明评级依据。依据为来源《研究人员证据简报》,该简报采用标准的证据综合规范。评级取决于研究类型、独立来源的数量、不同研究之间的一致性,以及与问题的直接相关性。该方法类似于健康研究中的 GRADE,并针对 CSE / SRHR 评估中常见的混合证据基础做了调整。
置信度标签的默认内容(v3 输出中原文保留;将方括号中的领域主题替换为相应内容):
- **我们对这一发现有信心。**多项独立开展的同行评审研究得出了相同结论。证据相互印证。
- **我们对这一发现比较有信心。**这一发现符合我们对 [领域主题] 运作方式的既有认识。针对我们所在地区(或这一具体方法)的评估有限。从业者经验表明该方法有效。已发表的比较数据尚未达到捐助方或外部读者通常期望的水平。
- **信心较低——证据仍在形成。**有理论或机制层面的理由认为该方法有效,但运营层面的评估尚未直接检验这一点。应将其视为有潜力的方法,而非已获证实的方法。
- **信心水平不一——因方法而异。**本条目中的研究结果处于不同置信度水平。简报正文会保留这些差异。
-
执行摘要——恰好 5 条要点。要点应体现区域模式,而不只是重述研究发现。
-
本简报的缘由——2–3 个段落。须包含 CoP 培育的框架性表述(简报本身就是一种 CoP 实践成果)。
-
区域概况——3 个子标题,点明构成分析背景的结构性变化(例如,针对某一区域:政策转变、资金转变、可用数据的变化)。每项变化均须逐字引用《证据简报》中的来源。
-
四项发现及跨 MA 证据——摘自《证据简报》的 RQ1 发现;每项发现都须添加一句“跨 MA 证据”,说明次区域模式。末尾以
**证据基础:**行收尾。 -
国家概况——N 个 MA 背景——每个概况均采用固定子结构:背景(1 段)→ 应用的杠杆(1 行)→ 有效做法(2–3 条要点)→ 无效做法(1–2 条要点)→ 经验教训(1 句话)。只有在《证据简报》未涵盖某一项时,才可省略该项。
-
跨领域策略——各概况的共同点——体现简报的分析贡献。指出各概况之间的模式(例如,杠杆与现有关系资本相匹配)。包含一个段落和一个简短列表。相较于 v1,这一章节是区域简报发挥价值的关键。
-
按 MA 模式提出的调整建议——3 种模式,各自对应不同的杠杆建议。每种模式都须提出一个诊断问题。末尾须为不符合这三种模式中任何一种的 MA 提供备选路径。
-
这对联合会意味着什么——最多 3 项行动。仅在此处提及联合会基础设施。
-
来源——列出简报来源清单中的完整证据基础。
-
本简报的编写过程——按照步骤 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 段。将所需决策加粗。提供可用于决策的摘要;读者可在 30 秒后停止阅读。
- 三个谈话要点 — 恰好三个。每个谈话要点为 1–2 段,且可用于口头简报。谈话要点取自证据简报中的 RQ1/RQ2/RQ3 发现。
- 预期问题 — 3–5 组问答。预先回答接收者最可能提出的问题。
- 所需决策 — 编号列出,内容具体。每项都是要求接收者作出的一项明确决策。不得提出含糊的请求。
- 来源 — 简短列表。使用引导语“For further details you can consult:”。从证据简报的来源中选取。
- 本备忘录的编制方式 — 溯源信息 + 必要时标注接收者占位符 + 根据步骤 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 | 公共政策语气;明确体现权利框架 | “尊重权利的政策”;“基于证据的立法立场” |
引用要求
每个学习产品都复用《证据简报》中已核实的引用。必须遵守以下规则:
- 引用只能来自《证据简报》或其
sources.md。仅此而已。 技能不得添加来源中没有的新引用。如果存在比简报所用来源更有力的来源,应将这一缺口交回 Researcher,而不是写入学习产品。 - 格式。 作者姓氏 + 年份 + 发表平台;适用时注明章节。Tier 1 工作简报将引用移至章节末尾的
**Evidence base:**行。 - 超链接。 复用《证据简报》中已核实的 URL。若来源中没有某个 URL,则标注
⚠️ URL unverified — confirm before publication。 - 时效性。 《证据简报》在制作时确保内容具有时效性;学习产品沿用这一要求。如果《证据简报》的日期早于 12 个月前,技能会在溯源页脚标记
⚠️ Source brief is older than 12 months — confirm currency before external use。 - 相互冲突的来源。 如果《证据简报》标记了 Tier 1 来源之间存在
⚠️ CONFLICT:,则在学习产品中保留此标记,不得掩盖冲突。 - 数据缺口。 如果《证据简报》标记了
⚠️ 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。各格式的调用入口如下:
| 格式 | 用途 | 模块调用入口 |
|---|---|---|
| Word | v3 默认;收件人为管理层时用 v4;按要求使用 v1 | ane_package.reporting.word_export.write_word_report |
| PowerPoint | v2 幻灯片 | ane_package.reporting.pptx_export.write_pptx_deck |
| v2 讲义;收件人为捐助方时用 v4;按要求使用 v3 | 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(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。