spec-write

Generate plan.md specification documents with template-driven structure and frontmatter validation.

140|20|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/HHU3637kr/skills --skill spec-write
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-write
Source: https://github.com/HHU3637kr/skills/tree/main/spec-write
Command: npx skills add https://github.com/HHU3637kr/skills --skill spec-write

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

撰写代码实现计划(plan.md)需要规范化、自动化,并由专门角色 spec-writer 触发,确保计划文档的一致性和可追踪性。

Core Features & Use Cases

  • 自动化撰写设计方案、API 规范、数据模型和架构设计的 plan.md,并对现有模板进行对齐。
  • 提供与模板和计划示例的引用,提升多人协作中的产出速度与一致性。
  • Use Case: 开发团队在 spec/ 目录需要新建 plan.md 时,自动生成初稿并等待用户确认以继续实现。

Quick Start

Create plan.md under the spec/ directory and let the skill generate a design plan ready for user confirmation.

Frequently Asked Questions about spec-write

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate writing a design spec or plan.md for a software project?

Automating design spec writing involves using a template-driven agent to generate the plan.md file. This skill enforces v2.0 constraints and frontmatter validation to automatically draft architectures and API specifications for user confirmation.

What is the best way to generate API specifications and data models for a refactor plan?

Generating API specs and data models is best handled by applying a single-agent execution to align with reference templates. This skill uses references/plan-template.md to standardize refactor plans and architectural designs automatically.

Can I use this skill to draft an architecture design plan from a template?

Yes, you can draft architecture design plans using this skill. It applies references like references/templates.md to validate frontmatter and ensure the generated plan.md aligns with v2.0 single-agent execution constraints.

Do I need a specific directory structure to create a spec?

Yes, you need to create a plan.md file specifically under the spec/ directory. The skill will then generate a design plan draft within this location, waiting for user confirmation before proceeding with implementation.

Why does the spec generation process require frontmatter validation?

Frontmatter validation is required to enforce v2.0 constraints and ensure single-agent execution consistency. It standardizes the plan.md structure by aligning outputs with the provided plan-template.md and templates references.