Draft Write

draft-write

This skill creates a first draft based on an approved outline.

It keeps the agent in a collaborator role and enforces human checkpoints.

When to Use

Use this skill when:

• An outline has been approved
• You need a draft for review and revision

Do NOT use this skill for:

• Outline creation
• Style-only polishing
• Publishing tasks

Required Workflow

1. Preconditions Check (Mandatory)

Before drafting, the agent MUST verify:

• There is an approved outline in content/outlines/<english-slug>.md
• The human has explicitly confirmed the outline is finalized (either original or after manual edits)
• The intended draft file path is confirmed (must use English filename following NAMING_CONVENTIONS.md)
• Scope limits are explicit

If any item is missing, STOP and ask.

2. Draft Execution (Controlled)

The agent MUST:

1. Confirm English filename if not already confirmed:

   • Use the same filename as the outline (matching <english-slug>)
   • Format: content/drafts/<english-slug>.md
   • Follow NAMING_CONVENTIONS.md rules

2. Create a draft in content/drafts/<english-slug>.md

3. Follow the outline section order

4. Use short to medium paragraphs

5. Mark any uncertain details with TODO: notes

The agent MUST NOT:

• Invent experiences or results
• Add new sections not in the outline without approval
• Use authoritative or conclusive tone
• Use Chinese characters in the filename

3. Post-Draft Summary (Mandatory)

After drafting, the agent MUST:

• Summarize what was written
• Highlight any TODO: items or gaps
• Ask whether to proceed to style polishing or revisions

Writing Constraints

• Practice-first, not theory-first
• Prefer first-person when appropriate
• Avoid tutorial-style imperatives
• No exaggerated AI capability claims

Guardrails (Hard Rules)

• ❌ Do not draft without outline approval
• ❌ Do not overwrite existing drafts without permission
• ❌ Do not auto-publish or move to published/
• ❌ Do not create files with Chinese characters in filenames
• ❌ Do not create files without following NAMING_CONVENTIONS.md

Success Criteria

This skill is successful when:

• A clear, reviewable draft exists
• The draft matches the approved outline
• The human has explicit next-step choices