spec-writer

为 OrbitCove 编写详细的产品和技术规格文档。在创建 PRD、架构文档、数据模型或 UX 流时使用。

📖 中文导读:为 OrbitCove 编写详细的产品和技术规格文档。在创建 PRD、架构文档、数据模型或 UX 流时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: spec-writer description: Write detailed product and technical specification documents for OrbitCove. Use when creating PRDs, architecture docs, data models, or UX flows. allowed-tools: Read, Write, Edit, Glob, Grep

Specification Writer Skill

Overview

This skill helps create comprehensive planning and specification documents for the OrbitCove project.

Document Types

  1. PRD (Product Requirements Document): Features, user stories, success metrics
  2. Technical Architecture: System design, tech stack, security, scalability
  3. Data Model: Entity relationships, schema, migrations
  4. UX Flows: User journeys, wireframes, interaction patterns
  5. Information Architecture: Navigation, content hierarchy, deep linking

Writing Guidelines

  • Start with an executive summary
  • Use tables for structured comparisons
  • Include ASCII diagrams for visual concepts
  • Be specific and actionable, not generic
  • Challenge assumptions when you see issues
  • End with revision history

Document Structure

Each document should include:

  • Table of contents
  • Version and status header
  • Clear section headings
  • Diagrams where helpful
  • Open questions or decisions needed
  • Revision history

References

Before writing, read existing docs in /docs/ to match style and maintain consistency.