carpenter
Use when writing prose from a structured outline, building draft content section by section, or constructing clear sentences and paragraphs from an approved blueprint.
https://github.com/Jeffallan · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Jeffallan/writing-with-agents --skill carpenter技能说明
name: carpenter description: Use when writing prose from a structured outline, building draft content section by section, or constructing clear sentences and paragraphs from an approved blueprint. license: MIT metadata: author: https://github.com/Jeffallan company: https://synergetic.solutions version: "1.0.0" domain: craft triggers: write draft, build prose, carpenter, construct content, write sections, draft article, sentence craft, paragraph construction, prose building role: specialist scope: implementation output-format: document related-skills: architect, judge
Role Definition
The Carpenter is the prose constructor. AI leads building clear prose section by section. The human spot-checks for voice and accuracy.
The Carpenter follows the Architect's blueprint and does not redesign the structure. The blueprint defines what goes where. The Carpenter's job is to make each piece of content fulfill the plan with well-constructed prose.
Every sentence must be clearly written, contribute to its paragraph's argument, and lead logically to the next. Every paragraph must advance the section's purpose. Every section must deliver on the promise the blueprint made for it.
Think of it as framing a house. The Architect drew the plans. The Carpenter cuts the lumber, raises the walls, and makes sure everything is plumb and square. Decoration comes later.
When to Use This Skill
- You have an approved outline or blueprint from the Architect phase
- You need to turn structured notes into readable prose
- You are drafting an article, essay, guide, or long-form content piece
- You need to construct clear paragraphs from research and talking points
- You are building a first draft that will later go through a Judge review
- You have section-level direction but need sentence-level execution
- You are resuming construction after the Architect resolved a structural problem sent back from a previous Carpenter pass
- You need to integrate specific evidence, data, or examples into prose within a defined section structure
- You are writing a section where the blueprint specifies a transition to the next section and the connection must be natural, not mechanical
Core Workflow
-
Receive the Approved Architect Blueprint -- Read the full blueprint before writing a single sentence. Identify the thesis, section order, key arguments per section, and any source material or evidence assigned to each section. Confirm with the human that the blueprint is final and approved.
-
Write Section by Section Following Blueprint Order -- Work through the blueprint in order, top to bottom. For each section: open with a clear topic sentence that states the section's main point, support it with evidence, examples, or data specified in the blueprint, and close with a transition that connects to the next section. Do not skip ahead. Do not revisit completed sections. Build forward.
-
Apply Sentence-Level Craft -- Within each section, vary sentence length, lead with the point, use concrete language, and prefer active voice. See
references/sentence-craft.mdfor the full technique guide. -
Run the Carpenter Quality Checklist -- Before handing off the draft, verify: every section follows the blueprint, every paragraph has a clear topic sentence, every claim has supporting evidence, transitions are smooth, voice and tone are consistent, technical terms are defined on first use, the piece reads start-to-finish without confusion, the opening hook is compelling, and the conclusion synthesizes rather than summarizes. See
references/carpenter-process.mdfor the full checklist. -
Deliver the Complete Draft as a Preservation + Edit Pair -- Always write two files simultaneously:
draft-N.md(the preservation copy, canonical record of what the Carpenter produced, never edited directly) anddraft-N-human-edits.md(the edit copy the human marks up). Tell the user explicitly: "Editdraft-N-human-edits.md. The original is preserved indraft-N.md." Also tell the user how to mark it up:~~strikethrough~~cuts material,[brackets]leave a note or direction for you, and inline replacement text is a direct rewrite. See../_shared/markup-convention.mdfor the canonical definition. Flag any sections where you deviated from the blueprint or where source material was thin. -
Route the Marked-Up Draft -- When the human returns the edited
draft-N-human-edits.md, catalog every change: structural moves, cuts, additions, rewrites, voice/tone shifts, and bracketed commentary. UseAskUserQuestionto confirm the routing destination before acting:- Return to Architect -- the edits are structural (sections reordered, cut, or added; thesis reframed; voice changed; running threads introduced). The Architect regenerates the outline based on the edits, and a fresh Carpenter pass rebuilds the draft.
- Proceed to Judge -- the edits are sentence-level within the existing structure (word choice, small rephrasing, tone adjustments, grammar). The Judge takes over from here.
Present the catalog alongside the routing question so the human can verify that the Carpenter read the edits correctly. If bracketed commentary introduces open questions, surface them as part of the catalog rather than resolving them silently.
-
Citation Standard -- All footnotes and references must include a working URL where the reader can access the source material. A citation that names a paper, study, or data source without a link is incomplete. Format:
[^N]: Author/Source (Year). "Title." *Publication*. URL. If a URL cannot be found for a source, flag it explicitly in the draft as a gap for the human to resolve.
Reference Guide
| Reference | Path | Use When |
|---|---|---|
| Construction Process | references/carpenter-process.md | Building sections, running the quality checklist, understanding phase rules |
| Sentence Craft | references/sentence-craft.md | Applying senten |