Communitygithub.com

brycewang-stanford/Awesome-Journal-Skills

用於準備《政策分析與管理期刊》(JPAM)論文的複製/透明度材料——將資料與程式碼存放於公開儲存庫,以便重現報告結果,並為限制使用的行政資料提供誠實的豁免路徑。此技能負責準備套件,但並非免除要求。

Awesome-Journal-Skills 是什麼?

此 AI 技能專為《政策分析與管理期刊》(JPAM)作者設計,協助建立論文複製套件,確保研究透明且可重現。它引導使用者將資料與程式碼妥善存放於具永久識別碼的公開儲存庫(如 ICPSR、Harvard Dataverse 或 OSF),並自動生成完整的複製腳本、說明文件與資料可用性聲明。特別針對政策研究中常見的限制使用行政資料(如涉及 IRB 或資料提供者授權),技能提供明確的豁免路徑:在聲明中解釋限制原因、提供存取申請方式與時程、並鼓勵提交合成或模擬資料讓程式碼可完整執行。支援平台包括 JPAM 指定的哈佛 Dataverse 及 Research Exchange,但會提醒使用者以 Wiley Authors 官網為主確認最新政策。技能透過互動式檢查清單(如主腳本是否重現所有圖表、軟體版本是否固定、資料可用性聲明是否草擬)及反模式提醒(如將套件視為接受後才處理的瑣事),幫助作者從分析過程就逐步建立套件,避免因複製問題導致發表延遲。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brycewang-stanford/Awesome-Journal-Skills/tree/HEAD/Journal-of-Policy-Analysis-and-Management-Skills/skills/jpam-transparency-and-data

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

透明度與複製資料 (jpam-transparency-and-data)

JPAM 發表影響實際支出決策的計畫評估,因此證據必須可重現。期刊期望作者將報告結果背後的資料與程式碼存檔於合適的公開儲存庫,並附上清晰的資料可用性聲明。請在研究過程中逐步建立套件,以免耽誤接受程序——並及早為政策工作常見的限制使用行政資料做好規劃。上傳前,請先在 Wiley Authors / Research Exchange 中確認最新文字說明(检索于 2026-06-20;以官网为准)。

何時觸發

  • 建置複製套件(資料 + 程式碼 + 說明文件)
  • 稿件即將被接受,且要求提交材料時
  • 資料為限制使用(行政、IRB 保護、提供者授權),需要豁免路徑時
  • 撰寫資料可用性聲明時

需要準備的項目

  1. 公開存放。 將複製材料存放於經認可的儲存庫(例如計畫的 ICPSR/openICPSR 檔案庫、Harvard Dataverse、OSF,或期刊指定的儲存庫),並附上永久識別碼——不要使用個人網站或暫時的雲端連結。近期的 JPAM 資料可用性聲明常使用 JPAM/Harvard Dataverse 儲存庫,而 Research Exchange 則控制確切的儲存庫提示。
  2. 重現每個報告的數字。 一個主腳本從原始/建置資料重新產生所有表格與圖形。稿件中的圖表編號必須與套件輸出完全一致。
  3. 說明文件。 一份 README,涵蓋資料來源、建置步驟、軟體/套件版本、隨機步驟的種子,以及重現每個圖表的確切指令。
  4. 資料可用性聲明。 說明共享了什麼、存放於何處、採用哪種授權;若資料為限制使用,則精確說明原因以及複製者如何取得存取權。

限制使用行政資料(政策研究案例)

政策評估常使用無法公開的連結行政或調查微資料。JPAM 的透明度期望可誠實地透過以下方式達成:

  • 解釋限制原因(法律、IRB、資料提供者授權)於資料可用性聲明中。
  • 提供存取指示——申請流程、提供者聯絡方式與大約時程,以便獨立複製者能取得相同資料。
  • 公開所有程式碼,加上任何可共享的衍生/彙整檔案,並在可行時提供合成或模擬資料,讓程式碼能完整端到端執行。

逐步建置檢查清單

  • 一個主腳本重新產生每個表格與圖形
  • README:資料來源、建置步驟、版本、種子、每個圖表的重現步驟
  • 軟體/套件版本固定(renv.lock / requirements.txt / 已記錄安裝)
  • 稿件圖表編號與套件輸出完全一致
  • 選擇具有永久識別碼的公開儲存庫(若期刊指定則使用指定者)
  • 資料可用性聲明已草擬
  • 限制使用資料:解釋限制原因 + 存取路徑 + 可行時提供合成資料

反模式

  • 將套件視為接受後才處理的瑣事(這可能阻礙發表)
  • 提交的程式碼實際上無法重現印刷的表格/圖形
  • 使用個人 URL 或會過期的雲端連結,而非永久儲存庫
  • 宣稱資料為限制使用,卻未提供存取路徑或合成替代品
  • 無說明、未設定種子、未固定版本的程式碼,僅「在我的機器上能跑」

校準錨點(保留彈性)

  • 政策評估高度依賴限制使用行政資料;誠實的限制說明加上實際的存取路徑,以及在合成/衍生資料上可執行的程式碼,是預期且可接受的路徑——這不是規避透明度的漏洞。
  • 確切的存放要求、儲存庫提示與重現檢查工作流程可能改變;請在 Wiley Authors / Research Exchange 中確認當前資料政策的文字說明。
  • 與分析過程同時建置套件:在接受後才改造以達重現性,正是政策論文卡關之處。

工作微範例(說明用)

一項福利改革評估使用了無法公開的連結州 UI 和 TANF 記錄。該套件仍滿足要求:資料可用性聲明說明了授權限制,並列出州政府資料請求流程與時程;所有程式碼連同主腳本一起存放;合成資料集比照變數結構,讓複製者能執行完整流程;另外也包含可共享的彙整表格。獨立研究人員能取得真實資料並重現每個數字。(說明用。)

輸出格式

【儲存庫】公開檔案庫 + 永久 ID —— 已選擇?[Y/N]
【可重現結果?】主腳本已在本機驗證?[Y/N]
【說明文件】README + 資料來源 + 種子 + 固定版本?[Y/N]
【限制使用資料?】已解釋限制原因 + 存取路徑 + 提供合成資料?
【資料可用性聲明】已草擬?[Y/N]
【下一步】jpam-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 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.

brycewang-stanford/Awesome-Journal-Skills

Use when preparing the transparency materials for a Public Opinion Quarterly (POQ) manuscript — the AAPOR-standard "Appendix A: Disclosure Elements", the replication package deposited to POQ's Harvard Dataverse, and the Data Availability Statement. POQ requires materials that reproduce exactly all published tables and figures, archived before typesetting. Prepares the materials; it does not waive requirements.

相關技能