technical-writing

编写技术设计文档(设计文档、规范、提案)。当创建设计文档、技术规范、项目提案或类似结构化技术内容时使用。触发词包括“design doc”、“デザインドック”、“設計書”、“仕様書”、“proposal”。

📖 中文导读:编写技术设计文档(设计文档、规范、提案)。当创建设计文档、技术规范、项目提案或类似结构化技术内容时使用。触发词包括“design doc”、“デザインドック”、“設計書”、“仕様書”、“proposal”。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: technical-writing description: Write technical design documents (design docs, specs, proposals). Use when creating design documents, technical specifications, project proposals, or similar structured technical content.

Technical Writing

Workflow

  1. Understand context: Problem, stakeholders, constraints
  2. Choose template: Based on document type
  3. Write: Section by section

Document Templates

See references/templates.md for:

  • Design Doc

Key Principles

Data-Driven Decision Making

Base design decisions on real data, not assumptions.

Problem First

  • Start with the problem, not the solution
  • Make the "why" compelling before the "how"