用途:在项目中创建或更新 Markdown 文档,以及编写面向 AI 的说明性内容(如技能文件 SKILL.md、规则等)时使用,帮助产出简洁、清晰、结构化且语气一致的文档。
主要能力:
- 新文档先出模板:用户提供模板则按其结构与章节;未提供模板时,先提出 1–2 个具体大纲选项(或最小默认模板:标题、概述、与文档类型匹配的章节),与用户确认或调整后再写正文。更新现有文档不需要该步骤,除非实际是从零新建。
- 核心原则:清晰、简洁、有结构、保持一致(术语、格式、语气统一)。
- 写作风格:主动语态、现在时、第三人称;避免不了的行话做简要解释;多用项目符号和表格提升可扫读性;句子简短。
- Markdown 格式:正确的标题/列表/代码围栏语法;行内代码、命令和文件路径用反引号;加粗用于强调,首次引入技术术语时可用斜体;章节之间留空行。
- 技能与规则专属:技能需包含带 name 和 description 的 YAML frontmatter,正文保持聚焦,按需渐进披露(仅在需要时链接 reference.md / examples.md);规则需匹配项目规则格式(如有 frontmatter 则沿用),指令保持可操作且范围明确。
使用方式:按上述触发条件应用;新文档先确认模板或大纲,再撰写正文。
适用场景:项目 Markdown 文档、AI 面向的技能与规则类文档的创建与编辑。
限制:资料未提供具体安装命令、平台信息或代码示例。