spec-writing

tbhb 的头像作者 tbhb

当用户要求"创建规格"、"编写规格"、"审查规格"、"更新规格"、"审查规格组织"、"拆分规格"、"向规格添加页面"、"从规格中删除页面"、"在页面间移动需求"、"添加需求"、"审查需求"、"更新需求"、"删除需求"、"添加测试"、"添加测试用例"、"审查测试"、"更新测试"、"删除测试"或需要关于规格结构、格式或规格编写最佳实践的指导时,应使用此技能。

📖 中文导读:当用户要求"创建规格"、"编写规格"、"审查规格"、"更新规格"、"审查规格组织"、"拆分规格"、"向规格添加页面"、"从规格中删除页面"、"在页面间移动需求"、"添加需求"、"审查需求"、"更新需求"、"删除需求"、"添加测试"、"添加测试用例"、"审查测试"、"更新测试"、"删除测试"或需要关于规格结构、格式或规格编写最佳实践的指导时,应使用此技能。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: spec-writing description: This skill should be used when the user asks to "create a spec", "write a specification", "review a spec", "update a spec", "review spec organization", "split a spec", "add a page to spec", "remove a page from spec", "move requirements between pages", "add requirements", "review requirements", "update requirements", "delete requirements", "add tests", "add test cases", "review tests", "update tests", "delete tests", or needs guidance on spec structure, formatting, or spec writing best practices. version: 0.1.0

Specification writing

This skill provides guidance for creating, reviewing, and improving technical specifications. It includes progressively-disclosed references on spec structure, formatting, requirement writing, test case design, and best practices for clear and effective specification documents.

About specifications

Specifications define formal requirements, behaviors, and interfaces for components, systems, or processes. They serve as authoritative references for development, testing, and validation activities.

Steps

MANDATORY STEPS FOR ALL SPEC WRITING TASKS

  1. Gather context - Run oaps skill orient spec-writing to see available references

  2. Identify relevant references - Review the references table from step 1 and select those matching your task

  3. Load dynamic context and references - Run oaps skill context spec-writing --references <names...>

  4. Review loaded references and commands - Read through the guidance. The Allowed commands table at the end of the output is authoritative for what commands can be run.

  5. Follow the workflow - Adhere to the selected workflow's steps for structuring, writing, reviewing, or improving the specification.