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
- Understand context: Problem, stakeholders, constraints
- Choose template: Based on document type
- 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"