# Paper Workspace

> Set up a diff-approval paper workspace: journal guidelines fixed in 01_requirements.md, 02_plan.md as the thick spec, one Markdown file per section, Pandoc + CSL to Word, Git required. AI edits only manuscript files; data is read-only. Ends with ai-use-disclosure. Use when starting a new paper or migrating a draft into a diff-approval workflow.

- Skill: `koach08/paper-workspace` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add koach08/paper-workspace`
- Raw SKILL.md: https://api.skillmd.com/api/skills/koach08/paper-workspace/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: koach08 (https://skillmd.com/u/koach08)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/koach08/paper-workspace

---


# Paper Workspace — diff承認型の論文作業場

## 前提ソフト
pandoc, git, (任意) Zotero + Better BibTeX で `references.bib` を書き出す。
確認: `which pandoc git`

## 初期化
1. `mkdir <paper> && cd <paper> && git init`
2. templates/ の雛形をコピー（このスキルの `templates/`）
3. `01_requirements.md` に投稿規定を貼る（語数、構成、引用スタイル、図表数、倫理記載）。**これがプロジェクトの法律**
4. `02_plan.md` を書く。ここを厚くする（AIの文が淡白になるのはここが薄いから）:
   - RQ、主張1文、各セクションで言うこと、使う根拠（`cec-table` の表を貼る）、先行研究との差分
5. `make.sh` で Word 出力を確認（空でも通ること）

## 執筆ループ（1セクションずつ）
1. AI に「`0N_<section>.md` を `02_plan.md` の該当行に従って書け。変更は diff で提示。承認前に書き込むな」
2. diff を読む。承認 → 書き込み → `git commit -m "<section>: <何をしたか>"`
3. 前提を変えた場合は「他のセクションで影響が出る箇所を列挙せよ」と別に指示する（自動では波及しない）
4. 全セクション後: `bash make.sh` → `output/paper.docx`

## 順序
Introduction → Methods/Materials（人文系なら「資料と方法」）→ Results/Findings → Discussion → Abstract は最後

## 安全装置
- AI が触ってよいのは `0*_*.md` と `references.bib` の並びだけ。`data/` は読み取り専用
- 引用は `[@key]` 形式のみ。存在しない key を作らない（`citation-verification` で実在確認）
- 各コミットが「戻せる地点」。詰まったら `git log` から戻す

## 仕上げ
- `cec-table` で表と本文の対応を再確認
- `ai-use-disclosure` で申告文を作り、規定の位置に入れる
- 英語なら humanize は「自分の声に戻す」目的に限る（検出回避に使わない）

## 査読対応
- 査読コメントを `review/round1.md` に貼る → 「対応方針表（コメント / 対応 / 本文の変更箇所）」を作らせる → 各変更を diff 承認 → `paper-review-reply` でレター