产品与设计
当需要把 Researcher Evidence…
把一个 literature-reviews/<slug>/evidence-brief.md 按四种受众格式转成学习产品,只复用已核验来源并套用 IPPF 品牌规范。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
当需要把 Researcher Evid特定
解决思路
- 确认输出类型:`ma-brief`(v1)、`workshop-cop-pack`(v2)、`regional-learning-brief`(v3)、`donor-management-memo`(v4);缺失或含糊时一次性向 Ane 询问。
- 收集输入:Evidence Brief slug 必填;输出类型必填;v4 必填 recipient,取值为 `donor-programme-officer`、`donor-senior`、`ippf-en-management`、`ippf-central-management`、`mp-or-policy`;可选 audience focus、length override、v2 workshop format(默认 `single-90min`,可选 `two-session-split`、`half-day`、`full-day`)、v2 workshop modality(默认 `in-person`,可选 `hybrid`、`virtual`)、v3 country snapshot count(默认 4,允许 3–5)、v3 country naming convention(默认 `sub-region-label`,可选 `country-name`)、v4 decision asked。
- Session start:完整读 SKILL.md;读 `literature-reviews/<slug>/evidence-brief.md`;读对应示例 `agent-improvements/learning-product-exemplar-v[1|2|3|4].md`;若上下文中没有,每会话读一次 `~/.claude/CLAUDE.md` 的 audience-tier register 部分。
- Step 1 parse inputs and route:识别输出类型;缺失或含糊时用一轮询问确认,并列出四个选项:`ma-brief`(2-page MA brief)、`workshop-cop-pack`(workshop + CoP pack)、`regional-learning-brief`(5–8 page federation brief)、`donor-management-memo`(1-page memo)。
- Step 1:若选择 `donor-management-memo` 但未提供 `recipient`,在同一轮询问中补问。
- Step 2 load source material:按顺序读 `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` 作为结构目标。
- Step 2:使用 Evidence Brief frontmatter 中的 `region`、`period`、`confidence` 元数据填充输出标题块。
- Step 3 apply the output-type sub-prompt:路由到 v1/v2/v3/v4 对应子提示,用 Evidence Brief 内容实例化对应示例的结构。
- Step 4 quality gates:BLUF 纪律——第 1 句给结论,第 2 句给承重理由;v1 headline 最多 3 行加粗;v3 executive summary 精确 5 个 bullet;v4 bottom line 1 段并加粗 decision-ask。
- Step 4:Voice register——默认 Tier 1 working brief;v4 仅在 decision-asked 部分解锁 directive register;v2 facilitator notes 对流程步骤用 directive verbs。
- Step 4:Citation placement——Tier 1 working brief 中把 framework names 移出正文;在 section 末尾放 `**Evidence base:**` 行;v2 source slide 用 `For further details you can consult:` 引导短语。
- Step 4:Citation rigour——作者姓氏 + 年份 + venue + 适用时 section;逐字取自 Evidence Brief;绝不虚构。
- Step 4:Hyperlink policy——只复用 Evidence Brief 或其 `sources.md` 中出现的 URL;绝不虚构;源中不存在的 URL 标 `⚠️ URL unverified — confirm before publication`。
- Step 4:Session-time URL audit——返回草稿前按 IPPF/UNFPA hyperlink standard 核验每个引用 URL。
- Step 4:URL audit——聚合器包装页(`consensus.app`、ResearchGate、academia.edu、Wikipedia)必须替换为 canonical publisher URL 或 DOI;聚合器只能作为补充,不能作为唯一来源。
- Step 4:URL audit——指向 paywall 的 DOI 链接必须尽量补充 open-access alternative(PMC、机构仓库、出版社托管开放 PDF、作者手稿)。
- Step 4:URL audit——出版社迁移 URL(如 Rowman 到 Bloomsbury、期刊 venue 变化等)必须更新为当前 canonical URL。
- Step 4:URL audit——返回 404 的 URL 必须替换为 canonical permanent link(通常是 UNESDOC、DOI 或机构仓库)。
- Step 4:URL audit——canonical 来源没有 open-access alternative 且受众为非学术读者时,引用必须标注 `paywalled, no open-access alternative found`。
- Step 4:URL audit——每个 Evidence Brief 只在会话时运行一次,缓存 URL substitutions,并在同一来源生成的所有 v1/v2/v3/v4 输出中复用。
- Step 4:Sentence length——低于 25 词;主动语态;正文不使用 em-dashes;能用动词时不用 nominalisations。
- Step 4:Narrative prose model + fidelity gate——v1 vignettes 和 v2 CoP workshop scenarios 可用 Fable per-call override 起草;若任一段叙事由 Fable 起草,必须对源 Evidence Brief 运行 prose-fidelity gate(policy 中 Gate 2)于 Sonnet,并清除所有 flag 后才可纳入。
- Step 4:v4 donor / management talking-points memo 及任何 persuasive 或 management-decision 内容留在本技能自己的模型(Opus/Sonnet);不得使用 Fable;即使如此,也要运行 prose-fidelity gate,重点关注 overstatement 和 attribution inflation。
- Step 4:Plain English——优先 Anglo-Saxon 而非 Latinate;首用缩写要展开;对 ECA / SSA / MENA 读者做 translatability test。
- Step 4:Disaggregation default——Evidence Brief 带有 WG-SS、age、gender identity、geography breakdown 时,输出要保留 disaggregation,不要合并掉。
- Step 4:Cross-MA naming——默认使用 sub-region labels(Western Balkans MA、Caucasus MA、Baltic MA、Visegrád MA),除非 Evidence Brief 或 Ane 明确点名国家;国家层级命名触发 redaction-candidate flag。
- Step 4:IPPF Visual Identity 2025——Word、PPTX、PDF 输出都走 `ane_package.reporting` brand template entry points;不得硬编码颜色、字体或格式。
- Step 5 provenance footer:每个输出末尾加 `## How this <product> was made` 块。
- Step 5:provenance 块第一段写明源 Evidence Brief(slug + date)、所用 voice register、brand template path。
- Step 5:加 `**Cross-MA references named:**` 行,列出正文中提到的每个 MA cluster 或国家。
- Step 5:加 `**Redaction candidates:**` 列表,列出联邦读者在外部使用前可能想移除的具体 MA、国家或具名个人;若正文只用 sub-region labels,则写 `none at sub-region level`。
- Step 5:v2/v3/v4 加 `**Companion artefacts in the four-exemplar series:**` 行,交叉引用另外三个输出为 `agent-improvements/learning-product-exemplar-v[N].md`。
- Step 6 return:把草稿作为 assistant turn 文本返回;若为 v2 workshop-pack,再通过 `ane_package.reporting` 生成 artefact files。
- Step 6:v2 slide deck → `pptx_export.write_pptx_deck`;handout one-pager → `word_export.write_word_report` 后经 `pdf_export.write_pdf_report` 导出 PDF;worksheet → 用 `word_export.write_word_report` 生成简单 Word 文件。
- Step 6:v1、v3、v4 作为 markdown body 返回;Ane 自行决定用现有 reporting modules 转 Word/PDF/PPT;v3 足够长,若 Ane 要求也可用 `word_export.write_word_report` 生成 Word。
- v1 默认长度 1,200 词(约 2 页);硬上限 1,500;低于 1,000 未通过实质密度测试。
- v1 结构:1 Title block——title、audience、length、date、voice、evidence(来自 brief 的 Tier 1/2 mix)。
- v1 结构:2 Headline——3 行 BLUF,第 2 行加粗结论。
- v1 结构:3 Why this brief——3–5 句,点明 Evidence Brief 的地理范围。
- v1 结构:4 What we know——3–5 个编号 findings,每个一段;findings 逐字或压缩自 Evidence Brief 的 RQ1 / Findings。
- v1 结构:5 Evidence base line——放在 What we know 末尾;加超链接;取自 brief 的 source list。
- v1 结构:6 Four levers your MA can use——3–4 个 levers;每个 lever 包含 action(1 句)、Why it works(1 段)、One-MA example(1 短段,默认 sub-region labels)、Resource estimate(1 行);仅当 Evidence Brief 无内容时才跳过子字段。
- v1 结构:7 What to do next quarter——单个具体行动;强制 one-lever commitment。
- v1 结构:8 Adaptation prompts for your context——4 个问题;问题邀请 MA 判断,而不是 Secretariat directive。
- v1 结构:9 Questions to bring to your next regional peer exchange——4 个问题,为 CoP convening 播种。
- v1 结构:10 How this brief was made——provenance + redaction candidates 按 Step 5。
- v1 voice:Tier 1 working brief,协作式;用 `We propose`、`your MA can`、`evidence suggests`、`MAs may adapt to context`;只有 compliance-subject 内容才用 directive voice,v1 中无此类内容。
- v1 quality bars:Adaptation prompts 必须是问题,不是陈述。
- v1 quality bars:每个 lever 必须有 Why-it-works 段;缺失会使 brief 低于 USAID Learning Brief implementer-audience 标准。
- v1 quality bars:`What to do next quarter` 必须强制 one-lever commitment,不是多选项菜单。
- v1 quality bars:当源 Evidence Brief 带 finding-level confidence markers(HIGH / MODERATE / LOW / MIXED)时,在 `What we know` 中每个 finding 旁保留它们;压缩为单一评级会掩盖差异。
- v2 默认设置:单次 90 分钟 session;8–15 名参与者;in-person modality;完整包(slides + facilitator notes + handout + worksheet + pre-read + post-event prompts)。
- v2 结构:1 Pack metadata block——workshop title、scope、audience、length、modality、date、voice、source brief、CoP cultivation framing。
- v2 结构:2 Pre-event materials——pre-read(若存在 v1 brief 则用它,否则用 Evidence Brief executive summary);pre-event diagnostic(4 个问题);facilitator briefing(1 页)。
- v2 结构:3 Slide deck——默认 14 张,结构为 cover(1)→ BLUF and diagnostic-feedback(2–3)→ findings(4–7)→ group-work segment 使用 1-2-4-All 或等价 Liberating Structures microstructure(8)→ levers(9–12)→ pair work with worksheet(13)→ plenary commitments(14)→ sources(15);允许 ±1 张,但不得少于 12 或多于 17;每张 slide 带 content、facilitator note(time + what to do + what to draw out + watch-for cue),相关时带 hybrid/virtual adaptation。
- v2 结构:4 Handout one-pager——Side A 用 4 行表格列 4 findings;Side B 用 4 行表格列 4 levers 并加 closing question。
- v2 结构:5 Worksheet——单页:Lever picked、Why this lever for your context、First 30 days week-by-week、What you need from the federation、What will tell you it worked。
- v2 结构:6 Post-event materials——48-hour email(commitments table + questions list + CoP-cultivation framing);week-6 peer-exchange prompt(2 个问题);facilitator AAR(4 个问题,仅 facilitator)。
- v2 结构:7 Hybrid and virtual adaptations——按 microstructure 内联注释。
- v2 结构:8 Materials checklist——用于 in-person session。
- v2 结构:9 How this pack was made——provenance + redaction candidates 按 Step 5。
- v2 voice:slide content 全程 Tier 1 working brief 协作式;facilitator notes 对流程步骤用 directive verbs,如 `Read the BLUF aloud. Pause. Ask...`,这是流程性而非 register shift。
- v2 quality bars:小 group segment 必须出现 1-2-4-All microstructure(Lipmanowicz & McCandless 2013)或等价 Liberating Structures 方法;不能只写 `discuss in pairs` 而无结构。
- v2 quality bars:每张 slide 必须有 per-slide facilitator note;仅当确实没有 watch-for 时才跳过(罕见)。
- v2 quality bars:Post-event materials 是包的一部分,不是可选;没有它们就只是 workshop,不是 CoP-cultivation pack。
- v2 quality bars:slide-15 source slide 用 `For further details you can consult:`,不是裸 `Source:`;投影 body font ≥20pt。
- v2 quality bars:CoP cultivation framing 要明确——workshop 是 building CoP 的第一次 convening;commitments 和 worksheets 是第一批 practice artefacts。
- v2 quality bars:当源 Evidence Brief 超过 4 个 findings,从 slide deck(slides 4–7)去掉 LOW-confidence 和 LOW–MODERATE-confidence findings;把它们保留在 handout 的 evidence base 和 source slide;slide deck 只放 4 个 finding slides,handout 吸收溢出。
- v2 quality bars:若当前会话中 `ane_package.reporting.pptx_export` 不可用(技能在工作文件夹外运行,或未安装 `ane_package`),退回 markdown deck specification——逐 slide 内容 + facilitator notes——并指示 Ane 在工作文件夹运行 PPTX 生成;PPTX 优先但不阻塞。
- v2 quality bars:可选 `cop-state` 参数(默认 `building` / `established`)控制 CoP framing;`building` 用 `first convening of a building CoP`;`established` 用 `[N]th convening of the [name] CoP`,N 和 name 在调用时传入。
- v2 brand application:slide deck 走 `pptx_export.write_pptx_deck`;handout 走 `word_export.write_word_report` → PDF;worksheet 走 `word_export.write_word_report`;Power BI / Tableau exports 不适用。
- v3 默认长度 3,000–5,000 词(约 5–8 页);默认目标 6 页(约 3,200 词)。
- v3 默认 country snapshot count 为 4;范围 3–5。
- v3 默认命名规范为 sub-region labels。
- v3 结构:1 Title block——title、audience(federation-wide MELers、senior leadership、donor programme officers、policy researchers)、length、date、voice、source brief。
- v3 结构:2 How to read this brief——放在 Title block 与 Executive summary 之间;两部分:note on language 子段,点名 brief 中使用的 acronyms 并指向末尾 glossary;note on confidence levels 子段,定义每个 confidence label 并加一句评级依据。
- v3 结构:2 的 confidence basis:依据是源 Researcher Evidence Brief,其应用标准证据综合纪律;评级取决于 study type、独立来源数量、跨研究一致性、与问题的直接性;方法类似 health research 的 GRADE,但适配 CSE / SRHR evaluation 的 mixed evidence bases。
- v3 结构:2 默认 confidence-labels list 在所有 v3 输出中原样保留,并把 bracketed 的 domain topic 替换为对应主题:`We are confident in this finding.` 多个 peer-reviewed 独立研究指向同一答案,证据收敛。
- v3 结构:2 confidence label:`We are fairly confident in this finding.` 符合已知 [domain topic] 运作方式;本区域或该具体方法的 evaluation 有限;practitioner experience 显示效果;published comparative data 尚未达到 donor 或 external reader 期望水平。
- v3 结构:2 confidence label:`Less confident — emerging evidence.` 有理论或机制理由认为方法有效;operational evaluation 尚未直接测试;视为 promising 而非 proven。
- v3 结构:2 confidence label:`Mixed confidence — varies by approach.` 该 bullet 内 findings 处于不同水平;正文保留差异。
- v3 结构:3 Executive summary——精确 5 个 bullets;bullets 承载 regional pattern,而不只是重述 findings。
- v3 结构:4 Why this brief——2–3 段;包含 CoP-cultivation framing(brief 本身是 CoP practice artefact)。
- v3 结构:5 The regional landscape——3 个 sub-headers,命名框定分析的 structural shifts;每个 shift 逐字引用 Evidence Brief sources。
- v3 结构:6 Four findings with cross-MA evidence——取自 Evidence Brief RQ1 findings;每个 finding 加一句 `Cross-MA evidence`,点名 sub-region pattern;以 `**Evidence base:**` 行收尾。
- v3 结构:7 Country snapshots — N MA contexts——每个 snapshot 固定子结构:Context(1 段)→ Lever applied(1 行)→ What worked(2–3 bullets)→ What did not work(1–2 bullets)→ Lesson(1 句);仅当 Evidence Brief 未覆盖时跳过某行。
- v3 结构:8 Cross-cutting strategy — what the snapshots share——brief 的分析贡献;点明跨 snapshots 的模式(例如 lever-fit follows existing relational capital);1 段加短列表;这一节让 regional brief 相对 v1 有价值。
- v3 结构:9 Adaptation prompts by MA pattern——3 个 patterns,每个导向不同 lever recommendation;每个 pattern 用 diagnostic question;结尾给不适合三种 patterns 的 MA 一个 fallback path。
- v3 结构:10 What this means for the federation——最多 3 个 actions;这是唯一点名 federation infrastructure 的地方。
- v3 结构:11 Sources——来自 brief source list 的完整 Evidence base。
- v3 结构:12 How this brief was made——provenance + redaction candidates + companion artefacts 按 Step 5。
- v3 voice:Tier 1 working brief,federation-wide collaborative;面向全联邦 MELers 和 senior leadership;承认联邦的 MA-led architecture,而不是宣称 Secretariat authority。
- v3 quality bars:Executive summary 永远精确 5 bullets;federation-wide leadership audience 只读 bullets。
- v3 quality bars:Country snapshots 使用固定子结构;snapshot 长度差异是质量失败。
- v3 quality bars:Cross-cutting strategy section 必须浮现跨 snapshots 的模式,不是重述 findings。
- v3 quality bars:Adaptation prompts 必须是 diagnostic questions,不是 directives。
- v3 quality bars:Federation actions 最多 3 个;4 个会稀释注意力。
- v3 quality bars:默认 sub-region labels;任何 country-level naming 必须显式带 redaction-candidate flag。
- v3 quality bars:当源 Evidence Brief 带 finding-level confidence markers,在 `Four findings with cross-MA evidence` 中每个 finding 旁保留它们;同 v1 要求。
- v3 quality bars:当源 Evidence Brief 有 3+ data gap entries,在 `What this means for the federation` 与 `Sources` 之间加 `What we don't know` section,取自 brief 的 data gap inventory,作为第 11 个结构元素。
- v3 quality bars:保留源 brief 的精确 regional label form;若 brief 用 `Visegrád / Central Europe`,不要未经首次使用保留 alternative label 就压缩为 `Visegrád MA`。
- v4 默认长度 900 词(约 1 页);硬上限 1,500;超过 1,500 则拆成两个 memos 或升级为 v3。
- v4 结构:1 Title block——title、audience(named recipient role)、length、date、voice、source、decision asked stated at top。
- v4 结构:2 Bottom line——1 段;加粗 decision-ask;decision-grade summary;读者 30 秒后可停止阅读。
- v4 结构:3 Three talking points——精确 3 个;每个 1–2 段,可转述为口头 briefing;取自 Evidence Brief 的 RQ1 / RQ2 / RQ3 findings。
- v4 结构:4 Anticipated questions——3–5 个 Q&A pairs;预答 recipient 最可能问的问题。
- v4 结构:5 Decision asked——编号、具体;每项是 recipient 被要求做的离散决策;不要模糊请求。
- v4 结构:6 Sources——短列表;用 `For further details you can consult:` 引导短语;取自 Evidence Brief sources。
- v4 结构:7 How this memo was made——provenance + 如有需要加 recipient-placeholder flag + companion artefacts 按 Step 5。
- v4 voice:talking points 全程 Tier 1 working brief;decision-asked section 按 `~/.claude/CLAUDE.md` audience-tier register 解锁 directive register:`We request`、`We seek approval for`、`We ask the [recipient] to authorise.`
- v4 quality bars:Bottom line 精确 1 段,并加粗 decision-ask;不能有两个 BLUFs。
- v4 quality bars:Three talking points 精确 3 个;4 个稀释,2 个显得单薄。
- v4 quality bars:Anticipated questions section 必填,除非 Ane 明确 override。
- v4 quality bars:Decision asked 编号且具体;模糊请求(如 `we'd appreciate consideration`)是质量失败。
- v4 quality bars:Voice 仅在 decision-asked 解锁 directive;talking points 保持协作式;混用会产生不一致 register。
- v4 quality bars:Recipient parameter 在调用时必填;否则无法校准 voice。
- v4 quality bars:当源 Evidence Brief 在任一 finding 上是 MIXED 或 LOW,Anticipated questions section 必须明确处理 evidence limitations;donor due-diligence 无论如何都会暴露局限,预先回答是可信度动作。
- v4 recipient calibration:`donor-programme-officer`——operational;假定熟悉 programme-mechanics;decision-ask 用 `Continued funding at current level`、`approval of incremental additions`;具体说明 budget envelope。
- v4 recipient calibration:`donor-senior`——strategic;pattern-level argument;decision-ask 用 `Endorsement of the framework`、`indication of multi-year intent`。
- v4 recipient calibration:`ippf-en-management`——federation-respecting;MA-priority counter-balance 可见;decision-ask 用 `Secretariat capacity`、`convening role`、`infrastructure`。
- v4 recipient calibration:`ippf-central-management`——federation-wide pattern;Vision 2030 / Strategic Framework alignment 可见;decision-ask 用 `Cross-region applicability`、`model for adaptation`、`federation learning architecture`。
- v4 recipient calibration:`mp-or-policy`——public-policy register;rights-frame 可见;decision-ask 用 `Rights-respecting policy`、`evidence-informed legislative posture`。
- Citation requirements:citations 必须来自 Evidence Brief 或其 `sources.md`;技能绝不增加源中没有的新 citation;若存在比 brief 更强的来源,缺口回到 Researcher,而不是放进 learning product。
- Citation format:作者姓氏 + 年份 + venue + 适用时 section;Tier 1 working brief 把 citations 移到 section 末尾的 `**Evidence base:**` 行。
- Citation hyperlinks:复用 Evidence Brief 的已验证 URL;源中不存在的 URL 标 `⚠️ URL unverified — confirm before publication`。
- Citation recency:Evidence Brief 在生产时执行 recency;learning product 继承之;若 Evidence Brief 超过 12 个月,在 provenance footer 标 `⚠️ Source brief is older than 12 months — confirm currency before external use`。
- Citation conflicting sources:若 Evidence Brief 在 Tier 1 sources 之间标了 `⚠️ CONFLICT:`,把 flag 继续带入 learning product;不要掩盖。
- Citation data gaps:若 Evidence Brief 标了 `⚠️ Data gap:`,learning product 用同样格式在原位保留缺口;不要省略。
- Cross-MA naming and redaction-candidate protocol:默认 federation-trust posture 是在 sub-region cluster level 命名 MA 工作(Western Balkans MA、Caucasus MA、Baltic MA、Visegrád MA),除非 Evidence Brief 或 Ane 明确点名国家。
- Cross-MA naming:当正文出现国家或具名个人,在 provenance footer 末尾加 `**Redaction candidates:**` 列表;每项写明若未经检查对外发布有何风险(敏感内容上的具体 MA 暴露、具名个人、具名 pilot site);列表供 Ane 外部使用前人工审查。
- Cross-MA naming:当正文只用 sub-region labels,列表写 `**Redaction candidates:** none at sub-region level`。
- Brand application:每个 artefact 通过 `ane_package.reporting.brand.IPPF_FORMAT_TEMPLATE` 携带 IPPF Visual Identity 2025。
- Brand application:Word 用于 v3 默认;v4 当 recipient 为 management;v1 若被要求——入口 `ane_package.reporting.word_export.write_word_report`。
- Brand application:PowerPoint 用于 v2 slide deck——入口 `ane_package.reporting.pptx_export.write_pptx_deck`。
- Brand application:PDF 用于 v2 handout;v4 当 recipient 为 donor;v3 若被要求——入口 `ane_package.reporting.pdf_export.write_pdf_report`。
- Brand application:Markdown 用于所有输出类型的 assistant turn(text body)。
- Brand application:不得硬编码 colours、fonts 或 formats;每次 reporting call 都从 `IPPF_FORMAT_TEMPLATE` 读取;Tier 2 publication-standard exception(donor 自有品牌、peer-reviewed venue)需要显式 override,并在文件中记录 deviation。
- Writing rules:逐字遵循 `~/.claude/CLAUDE.md` 的 writing-style section;主动语态;句子低于 25 词;正文无 em-dashes;无 filler(`in order to`、`it should be noted`);能用动词时不用 nominalisations;无抽象开头;无 rhetorical questions;先陈述要点。
- Writing rules:Anglo-Saxon 优先于 Latinate,只要意义存活:用 use 不用 utilise;用 start 不用 commence;用 help 不用 assist;用 check 不用 ascertain;用 run 不用 facilitate(除非 facilitate 指 workshop role)。
- Writing rules:每个文档中 acronyms 首用展开;CSE 首次出现必须写 Comprehensive Sexuality Education,即使受众已知。
- Writing rules:每句做 translatability test:Romanian、Tunisian、Ethiopian 或 Vietnamese English-speaking reader 能否首读理解?删除 idioms。
- Limitations:不产出底层 Evidence Brief——那是 `researcher` skill。
- Limitations:不在 session time 验证 hyperlinks——那是 Researcher 在 brief production time 的职责;本技能只复用已验证 URL。
- Limitations:不生成 diagrams、infographics 或 video——属于独立 workflow。
- Limitations:不虚构 cross-MA cases、具名个人或 Evidence Brief 中没有的具体 pilot sites。
- Limitations:不决定是否对外发布输出——该决定在 redaction-candidate review 后交给 Ane。
- Limitations:不替代 MA-led adaptation;输出以 Tier 1 working brief register 起草,邀请 MA 判断,不是 federation directives。
- Vi specialist registration:本技能也注册为 Vi specialist `learning-product-designer`,位置 `agent-improvements/agent_registry.md`;当 task brief 要求 learning product 与其他 deliverables 一起时,Vi 会 spawn specialist;specialist 读取同一 Evidence Brief slug,并通过同一 router 产出同样四类输出。
- Edit-preservation protocol:若 Ane 按路径引用现有输出并要求改进、迭代或扩展,协议激活;先读文件,再用 Edit tool 做 scope-bounded edit,超范围内容保持 byte-identical,并返回 EDIT-PRESERVATION DELIVERY summary。
- Edit-preservation protocol:目标文件存在时应用 `mel_wiki/wiki/concepts/edit-preservation-protocol.md`。
适用边界 · 注意事项
- 不要用于产出底层 Evidence Brief——那是 `researcher` skill。
- 不要用于不来自 Researcher Evidence Brief 的一般决策备忘录(用 `decision-memo` skill)、评估设计/指标设计或 ToC 构建(用 `toc-builder`)。
- 没有所需输入(尤其 Evidence Brief slug、输出类型;v4 的 recipient)或没有 IPPF/`ane_package` 环境时不要硬套,因为流程依赖特定内部工作目录、品牌模板与 Ane 流程。