# Product Spec Builder

> 将一句话或模糊产品创意整理成可验收的 Product Spec，并为已有产品记录增量变更。用于 0→1 产品定义，或新增能力、改变用户可见行为、公开 API、持久化格式、公开数据模型、权限和业务流程的产品变更；不用于只恢复既定行为的普通维护。

- Skill: `arctan303/product-spec-builder` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add arctan303/product-spec-builder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arctan303/product-spec-builder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: arctan303 (https://skillmd.com/u/arctan303)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/arctan303/product-spec-builder

---


# 需求构建技能 (product-spec-builder)

## Purpose

从用户文字中拆出真实目的、用户、场景、边界和成功条件，形成可验收的产品契约；不要把一句话包装成完整需求。

## Trigger

- 0→1：产品目标、用户、核心场景或首版范围尚未形成。
- 产品变更：新增或改变外部行为，但变更目的、范围、兼容性或验收记录仍缺失/不充分。
- “Bug 修复”实际需要重新定义正确行为。

有效决定已确认目的、外部行为和验收标准时，单一小改直接进入 `dev-builder`，需要阶段计划才进入 `dev-planner`；仅恢复既定行为、内部重构、测试、CI 或文档时不触发。

## Required context

- 用户原始想法、痛点或变更请求。
- 已有 Product Spec、仓库事实、接口和设计材料（如果存在）。
- 已确认约束、参考案例、截图、反例和不可接受结果。
- 当前已知事实、推断和未知项。

## Workflow

1. 先判断 0→1、产品变更或维护执行，不按用户使用的“优化/修复”字眼机械分类。
2. 抽取已知目的、目标用户、核心场景、外部行为、范围和非目标。
3. 只追问会改变路线、首版范围、公开行为或验收方式的高信息量问题；每轮通常 1 个，最多 2 个。
4. 信息足够时停止追问，把未知项写成临时假设或明确阻塞。
5. 0→1 生成 Product Spec；产品变更原位修订条款，标明待实现和旧决定替代关系。历史明细按需移出当前正文，不只追加相反声明。

## Output

- 路线与依据。
- 已确认事实、临时假设和待确认问题。
- 编号需求 `REQ-*` 与可观察验收标准 `AC-*`。
- `docs/Product-Spec.md` 或项目约定文件；产品变更包含变更 ID、兼容性、迁移、回滚和非目标。

## Stop or escalate

- 无法判断是恢复行为还是重新定义行为：最多追问 2 个关键问题。
- 目标用户、核心场景或成功条件缺失且会改变方案：停止等待确认。
- 依赖未确认的外部接口或业务规则：记录阻塞，不编造答案。
- 产品契约已充分且请求只是维护：转交 `bug-fixer` 或 `dev-builder`。

## References

执行前读取 [stage-contract.md](references/stage-contract.md)。