book-writing-workspace

これはレビュー時に保存された抜粋です。完全で最新の内容は外部ソースを確認してください。

---
name: book-writing-workspace
description: "Operate a reusable technical book manuscript workspace with writing structure, reader persona SSOT, review rules, and optional Markdown to Re:VIEW/PDF support. Use when organizing a book manuscript repo, defining or reviewing target readers, standardizing chapter/section files, setting writing/review agents, handling publisher proof comments, or assessing an existing writing workspace. Triggers on book writing workspace, reader persona, reader audience, 読者ペルソナ, persona SSOT, technical book project, 執筆ワークスペース, manuscript workflow, Re:VIEW workspace, proof PDF, annotated proof, publisher proof comments, 校正, 校正注釈, and 初校."
argument-hint: "本のテーマ、原稿リポジトリ名、使いたい執筆フロー"
user-invocable: true
license: CC BY-NC-SA 4.0
metadata:
  author: yamapan (https://github.com/aktsmm)
---

# Book Writing Workspace

Create and maintain a reusable manuscript workspace with folders, writing agents, instructions, review rules, and optional Markdown -> Re:VIEW -> PDF support.

## When to use

- **Book writing**, **technical writing**, **執筆プロジェクト**, **Re:VIEW**
- Assessing or standardizing an existing book manuscript repository
- Creating a new technical writing project from templates when needed
- Setting up Markdown → Re:VIEW → PDF workflow
- Upgrading an existing manuscript workspace so it can generate Re:VIEW output and printable PDFs
- Standardizing chapter/section file layout, writing rules, review workflow, and page allocation
- Adding optional Re:VIEW/PDF support without turning the writing workspace into a general Git or publishing operations toolkit

## Quick Start

Start by assessing the manuscript workspace, even when creating a new project:

1. Confirm the main manuscript lives in `sections/` and uses one file per section.
2. Confirm outlines or key points live separately from final manuscript files.
3. Confirm chapter intro files use kebab-case naming (e.g. `00-introduction/00-introduction.md`).
4. Locate the workspace's declared reader-persona SSOT; do not force a new file when an existing overview or planning document already owns it.
5. For a new workspace, use `docs/reader-personas.md` to define the primary persona, secondary personas, prior knowledge, and completion outcomes.
6. Confirm writing, heading, notation, page allocation, and review rules are available.
7. Decide whether Re:VIEW/PDF output is needed for this project; keep it optional unless the workflow requires it.

## Operating Workflow

When the workspace already exists, do not stop at setup-oriented advice. This skill should also support:

1. Normalizing manuscript folders and section naming.
2. Keeping outlines, drafts, final manuscript, and images aligned by chapter.
3. Running focused writing and review loops until P1/P2 issues are resolved.
4. Applying reviewer fixes without leaving outlines, chapter maps, question digests, and progress trackers out of sync.
5. Reviewing each chapter against the book-specific reader persona and expected outcome.
6. Checking word count targets and source confidence before finalizing text.
7. Measuring the built page count before treating a page-budget overrun as a structural problem; character-count estimates run high, and an author-side build is not the publisher's printed page count.
8. Ruling on external issues, pull requests, and publisher proof comments point by point, first confirming which revision the proof was typeset from, then verifying each factual claim against its source of truth.
9. Giving typeset-only elements such as chapter frontispieces a source of truth in the manuscript, marked so the converter can emit them, once it is settled that the author writes them.
10. Enabling Re:VIEW/PDF support only when the project needs reproducible output.
11. Freezing a release candidate and running the release-readiness gates before delivery or publication.

## Bootstrap Workflow

Use the setup script only when creating a new workspace or adding missing structure deliberately.

```powershe