AgentSkillsCN

flesh-out

将原始粗糙的文档草稿转化为结构化内容。适用于当文档仅是若干想法、笔记或意识流的骨架，需要的是生成式扩展而非精细润色时使用。

SKILL.md
--- frontmatter
name: flesh-out
description: Transform raw/crude document drafts into structured content. Use when a document is a skeleton of ideas, notes, or stream-of-consciousness that needs generative expansion rather than review polish.
argument-hint: <file|folder>...

This skill is for generative work on crude/raw content at $ARGUMENTS - not polishing drafts.

Stop after each stage and have changes reviewed with user.

Note: The developer's raw content captures intent. The agent expands and structures but must preserve the developer's meaning. When uncertain about intent, ask - don't assume.

See responsibilities.md for the full agent/developer ownership matrix.

  1. •

    Extract core ideas (developer leads)

    • •Read the raw content and identify the key concepts
    • •List what the developer appears to be saying (don't fix typos yet)
    • •Confirm understanding with developer before proceeding
    • •Identify gaps: "You mention X but don't explain Y - should I research this?"
  2. •

    Research and expand (agent leads with approval)

    • •Web search for external concepts if applicable
    • •Find industry terminology for rough ideas
    • •Identify related work the developer may want to reference
    • •Propose expansions - developer approves what to include
  3. •

    Structure the content (agent leads with approval)

    • •Determine appropriate document structure (based on template if available)
    • •Organize ideas into logical sections
    • •Create hierarchy (headers, sub-sections)
    • •Add diagrams or tables where relationships exist
  4. •

    Polish language (agent leads with approval)

    • •Fix spelling, grammar, terminology
    • •Expand acronyms on first use
    • •Ensure consistent usage throughout
    • •Add links to external references
  5. •

    Tidy up (agent leads with approval)

    • •Check with the user where to update the glossary
    • •Add terms that needed clarification
    • •Update references with new links

When to Use This vs Other Skills

Document StateUse
Raw notes, bullet points, stream of consciousnessflesh-out
Typos, incomplete sentences, but has structurereview-steps
Structured but missing sectionsflesh-out (or discuss scope first)
Complete draft needing polishreview-steps
Complete draft needing critical evaluationstrong-edit

Key Difference from Review

Review improves what exists within its structure. Flesh-out creates structure from raw ideas.

Review a skeleton -> correct but incomplete document. Flesh-out a skeleton -> complete document.