Communitygithub.com

brycewang-stanford/Awesome-Journal-Skills

在准备《公共舆论季刊》(POQ)稿件的透明度材料时使用——包括AAPOR标准的“附录A:披露要素”、提交至POQ哈佛Dataverse的复现包以及数据可用性声明。POQ要求材料能在排版前准确复现所有已发表的表格和图表。本技能协助准备材料,但不能豁免相关要求。

Awesome-Journal-Skills 是什么?

该技能专门针对《公共舆论季刊》(POQ)独特的透明度政策要求设计,帮助研究人员准备两项关键材料:AAPOR标准的方法论披露(附录A)和可在POQ哈佛Dataverse中存档的完整复现包。它通过清单驱动的方式逐步引导用户完成数据披露的八个核心要素(包括资助来源、问题措辞、样本设计、应答率计算等),并强制要求在排版前完成所有材料的归档。技能还涵盖了数据受限时的豁免路径(如提供合成数据或申请12个月禁运期),并提供了标准化的输出格式用于验证每个环节是否达标。主要适用于需要向POQ投稿或已被接收的研究人员,也适用于其他遵循类似AAPOR+Dataverse双重要求的社会科学期刊。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brycewang-stanford/Awesome-Journal-Skills/tree/HEAD/Public-Opinion-Quarterly-Skills/skills/poq-transparency-and-data-policy

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

透明度与数据政策(poq-transparency-and-data-policy)

POQ 有两项透明度要求,使其区别于一般的社会科学期刊:AAPOR 标准方法论披露(涵盖每项调查)和一个能够精确复现所有已发表表格和图表的复现包,该复现包需在论文进入排版前存入 POQ 的 Dataverse。建议在写作过程中逐步构建这两项材料,以免在稿件被接收后出现延误。

触发时机

  • 整理附录 A:披露要素(针对报告中涉及的每个数据集)
  • 为 POQ 的 Dataverse 构建复现/重现包
  • 稿件已被接收,期刊办公室要求在排版前提供相关材料
  • 数据无法完全共享(涉及隐私、伦理、数据提供方限制),需要走豁免路径

AAPOR 披露——附录 A:披露要素

POQ 要求稿件需对所有报告的数据披露以下要素(如适用),或链接至公开可用的文档,汇总在 “附录 A:披露要素” 中:

  1. 资助来源——数据收集的赞助方。
  2. 确切的问题措辞——所使用的所有调查问题的原文。
  3. 研究对象总体——清晰定义。
  4. 样本设计——抽样框、选择方法、分层、整群。
  5. 数据收集方法与日期——模式与实地调查期间。
  6. 应答率及其计算方法——依据 AAPOR 标准定义(注明 RR1–RR6,并展示处置代码计算过程)。
  7. 样本量及结果精度的讨论。
  8. 整群与加权导致的设计效应——讨论调整方法。

对于二手数据,链接至公开文档,而非重复生成。

复现包——POQ Dataverse(哈佛)

  1. 存入 POQ 的 Dataverse(位于哈佛 Dataverse,期刊的永久存档,带有永久标识符)——而非个人网站或通用云链接。
  2. 精确复现所有已发表的表格和图表:数据 + 代码 + 足够的文档,能够重新生成每个报告结果。需提供主脚本 + README + 固定版本 + 随机种子。
  3. 在排版前完成存档——已接收的稿件直到材料就绪才能进入排版环节。
  4. 在文章末尾提供数据可用性声明(DAS),说明数据获取方式与位置。

数据无法共享时(豁免路径)

  • 解释原因——数据为何受限(隐私、伦理、数据提供方/法律限制)。
  • 在 README 中提供确切说明,告知其他人如何获取数据(访问流程、联系人)。
  • 如有可能,提供合成数据,以便代码能够运行。
  • 可申请从文章发表起十二个月的禁运期(请确认当前条款——待核实)。

逐步构建清单

  • 附录 A 已为每个数据集起草了全部八个披露要素(或链接)
  • 应答率已注明 AAPOR 定义及计算过程
  • 一个主脚本能够重新生成所有表格和图表
  • README + 来源说明 + 随机种子 + 固定版本
  • 稿件中的图表编号与复现包输出完全一致
  • 数据可用性声明(DAS) 已为文章末尾部分起草
  • 受限数据:豁免说明 + 访问路径 + 合成数据 + 如需则申请禁运

反模式

  • 应答率未注明 AAPOR 定义或计算过程(附录 A 不达标)
  • 将数据存入视为发表后的附加工作(这会阻碍排版流程)
  • 代码无法实际复现已发表的图表
  • 使用个人网址而非 POQ 的 Dataverse
  • 声称数据受限,但未提供访问路径或合成替代方案

输出格式

【附录 A】所有 8 个披露要素均已呈现(或已链接)?[Y/N]
【应答率】AAPOR 定义与计算过程是否已展示?[Y/N]
【仓储】POQ Dataverse(哈佛)——复现包是否已准备就绪?[Y/N]
【表格/图表复现】主脚本是否已在本地验证通过?[Y/N]
【文档】README + 来源说明 + 随机种子 + 固定版本是否齐全?[Y/N]
【DAS】数据可用性声明是否已为文章末尾部分起草?[Y/N]
【受限数据】豁免说明 + 访问路径 + 合成数据 + 禁运申请是否已处理?
【下一步】poq-review-process

补充资源

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the data-availability statement and the data/code archive for a Conservation Biology manuscript. The journal (Wiley/SCB) requires a data-availability statement for research/synthesis articles, encourages data sharing, and requires sensitive species data to be protected. Prepares the package; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the data-availability statement and reproducibility materials for a Demography (PAA / Duke University Press) manuscript. Demography requires a data availability statement at acceptance with persistent identifiers and encourages reproducible, commented code; it hosts no repository, so authors deposit in a FAIR repository. Covers restricted-data exemptions. Prepares the materials; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Light: Science & Applications or deciding whether a photonics manuscript fits this venue. Encodes the journal's fit, the Nature-Portfolio significance bar, optical-measurement rigor, open-access house style, the Light-vs-Optica-vs-review routing, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Biomedical Engineering or deciding whether a biomedical-engineering / health-technology manuscript fits this venue. Encodes the journal's fit, the Nature-style biomedical-significance and translational bar, validation and evidence rigor, house style, the device-vs-biomaterials-vs-clinical routing, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Electronics or deciding whether an electronic-devices / circuits / systems manuscript fits this venue. Encodes the journal's fit, the Nature-style significance and field-advancing bar, device-and-system measurement rigor, house style, the device-vs-materials-vs-systems routing, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Biotechnology or deciding whether a biotechnology/enabling-methods manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Cell Biology or deciding whether a cell-biology manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Geoscience or deciding whether an earth science manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Materials or deciding whether a materials science manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when targeting Nature Nanotechnology or deciding whether a nanotechnology manuscript fits this venue. Encodes the journal's fit, framing, method-and-evidence bar, house style, official-submission re-check, and desk-reject heuristics.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the Data Availability Statement and replication materials for a Governance: An International Journal of Policy, Administration, and Institutions manuscript. Governance requires the statement (mandatory) and encourages sharing data/code in a DOI-citable repository, but does not run a verified pre-publication reproduction check like APSR. Builds the statement and materials; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the replication/transparency materials for an International Organization (IO) manuscript. IO's signature requirement is verification BEFORE final acceptance — the editorial staff request data and code at conditional acceptance, IO staff re-run quantitative results and check proofs of formal models, and editors withhold final acceptance until all reported results are confirmed; materials then deposit to the IO Dataverse with a DOI and a Data Availability Statement. Prepares the package; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the replication / transparency materials for a Journal of Policy Analysis and Management (JPAM) manuscript — depositing data and code in a public repository so the reported results can be reproduced, with an honest exemption path for restricted administrative data. Prepares the package; it does not waive requirements.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the data-availability statement and reproducibility materials for a Population and Development Review (PDR, Wiley / Population Council) manuscript. PDR follows Wiley's data-sharing and research-integrity expectations — a data availability statement, ORCID, and reproducible, well-documented materials deposited in a FAIR repository (verify current policy). Covers restricted-data exemptions. Prepares the materials; it does not waive requirements.

相关技能