# Spec

> 需求规格说明技能。当用户要求编写需求、撰写 spec、做需求分析、澄清功能边界时使用。触发词包括"写 spec"、"需求分析"、"需求规格"、"spec 文档"、"/spec"。

- **Type:** Skill
- **Install:** `agentstack add skill-simpleeve-development-skills-spec`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [SimpleEve](https://agentstack.voostack.com/s/simpleeve)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [SimpleEve](https://github.com/SimpleEve)
- **Source:** https://github.com/SimpleEve/development-skills/tree/main/spec

## Install

```sh
agentstack add skill-simpleeve-development-skills-spec
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Spec - 需求规格说明技能

将模糊的需求意图转化为清晰、无歧义的需求规格文档。

## 核心原则

1. **不猜测**：遇到任何模糊点，必须向用户提问澄清，绝不自行假设
2. **不模糊**：每个需求边界必须是确定的，In Scope / Out of Scope 必须明确列出
3. **不写代码**：绝不写任何代码，包括伪代码。只用自然语言描述需求行为
4. **固定产出**：输出到项目既有的需求目录；若无统一约定，建议使用 `spec//spec.md`

## 工作流程

### 第一步：理解与澄清

1. 阅读用户给出的需求描述
2. 阅读项目级背景文档（如 PRD、roadmap、里程碑文档；如果存在），理解整体背景
3. 阅读已有的需求文档，避免重复或冲突
4. **列出所有不确定的点**，逐一向用户澄清
5. 反复澄清直到无任何歧义

### 第二步：撰写 Spec

按照下方固定模板撰写，写入对应功能的 `spec.md`。

### 第三步：用户确认

将产出交给用户确认，根据反馈修订直到用户满意。

## 固定模板

```markdown
#  需求规格说明

> 状态：草稿 | 已确认
> 创建日期：YYYY-MM-DD
> 所属里程碑：如项目使用里程碑则填写，否则写"无"

## 1. 概述

### 1.1 功能简述
一句话说清楚这个功能做什么。

### 1.2 所属模块
标明属于哪个系统、子模块、包、程序集、服务或运行时区域。

### 1.3 关联文档
列出关联的 PRD 章节、roadmap、设计稿、其他 spec。

## 2. 用户故事与场景

### 2.1 目标用户
明确这个功能服务于谁。

### 2.2 用户故事
使用 "作为 ，我希望 ，以便 " 格式。

### 2.3 使用场景
描述 2-3 个典型使用场景，包含前置条件和期望结果。

## 3. 功能需求

### 3.1 输入
明确所有输入来源、格式、必填/选填。

### 3.2 输出
明确所有输出目标、格式、成功/失败的结果。

### 3.3 核心行为描述
用自然语言逐条描述系统在每个场景下的具体行为。
**禁止使用代码或伪代码。**

### 3.4 业务规则与约束
列出所有业务逻辑规则、限制条件、异常处理要求。

## 4. 非功能需求

### 4.1 性能要求
如有明确指标则列出，无则标注"无特殊要求"。

### 4.2 安全要求

### 4.3 兼容性要求

## 5. 边界与限制

### 5.1 明确包含（In Scope）
逐条列出本次需求范围内的内容。

### 5.2 明确排除（Out of Scope）
逐条列出本次明确不做的内容。

### 5.3 已知约束
列出技术或业务上的已知限制。

## 6. 验收标准（Acceptance Criteria）

使用 "Given-When-Then" 格式逐条列出：
- **Given** 
- **When** 
- **Then** 

## 7. 开放问题（Open Questions）

列出所有尚未解决的问题，标注负责人和期望解决日期。
如全部已解决则标注"无"。

## 8. 变更记录

| 日期 | 变更内容 | 变更人 |
|------|---------|--------|
```

## 关键约束

- **绝不写代码**：包括伪代码、代码片段、接口定义。这些属于 plan 阶段的职责
- **绝不猜测**：宁可多问一轮，也不要用"可能"、"大概"、"应该"这类词
- **一个 spec 一个功能**：不要在一个 spec 里塞多个不相关的功能
- **spec-name 命名规则**：使用小写英文 kebab-case，如 `user-auth`、`payment-retry`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [SimpleEve](https://github.com/SimpleEve)
- **Source:** [SimpleEve/development-skills](https://github.com/SimpleEve/development-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-simpleeve-development-skills-spec
- Seller: https://agentstack.voostack.com/s/simpleeve
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.