AgentSkillsCN

Book Map

书目地图

SKILL.md

/book-map

Scaffold, audit, and manage Book_Map projects.

Subcommands

/book-map scaffold

Scaffold the Book_Map structure in the current project directory.

Instructions for Claude:

  1. Read references/directory-spec.md for the complete file/directory specification.
  2. Create all required directories that do not exist.
  3. Create all required files that do not exist, using appropriate templates.
  4. For each file created, add the <!-- reviewed: YYYY-MM-DD --> freshness tag with today's date.
  5. Do NOT overwrite existing files — only create missing ones.
  6. After scaffolding, run the audit subcommand to verify completeness.

Output format:

code
Created: [list of files/dirs created]
Skipped: [list of files/dirs that already existed]
Run `/book-map audit` to verify completeness.

/book-map audit

Audit the current project against the Book_Map standard.

Instructions for Claude:

  1. Read references/checklist.md for the audit criteria.
  2. Check each criterion and report pass/fail.
  3. For each failure, reference references/remediation.md for the fix.
  4. Report an overall score (pass count / total count).

Output format:

code
Book_Map Audit Results
======================
[Category]: [pass/fail count]
  ✓ criterion description
  ✗ criterion description → fix: [remediation step]

Overall: [total pass] / [total checks] passed

/book-map add-book

Add a new book to the series.

Instructions for Claude:

  1. Determine the next book number by checking existing books/book-NN/ directories.
  2. Create the book directory structure:
    code
    books/book-NN/
      manuscript/
        _INDEX.md
        front_matter/.gitkeep
        chapters/
        back_matter/.gitkeep
      docs/
        _INDEX.md
        book/
          OVERVIEW.md
          OUTLINE.md
          CONTINUITY_BIBLE.md
    
  3. Populate each file with appropriate templates:
    • manuscript/_INDEX.md — empty chapter status table
    • docs/_INDEX.md — per-book doc index linking to book-specific and shared docs
    • docs/book/OVERVIEW.md — minimal book premise referencing series arc
    • docs/book/OUTLINE.md — empty outline with contract format
    • docs/book/CONTINUITY_BIBLE.md — initialized from previous book's final state
  4. Add the new book to books/_INDEX.md.
  5. Create a handoff template at series/handoffs/BOOK-NN-TO-MM.md (from previous book to this one).
  6. Update docs/_INDEX.md to include the new per-book documents.

Output format:

code
Created book-NN:
  books/book-NN/manuscript/_INDEX.md
  books/book-NN/manuscript/front_matter/.gitkeep
  books/book-NN/manuscript/chapters/
  books/book-NN/manuscript/back_matter/.gitkeep
  books/book-NN/docs/_INDEX.md
  books/book-NN/docs/book/OVERVIEW.md
  books/book-NN/docs/book/OUTLINE.md
  books/book-NN/docs/book/CONTINUITY_BIBLE.md

Updated:
  books/_INDEX.md
  series/handoffs/BOOK-[prev]-TO-NN.md
  docs/_INDEX.md