Claude Code requirements-writing:把模糊需求改成可测试的验收标准
EnglishClaude Code 安装步骤
- 打开 GitHub 固定提交的 `.claude/skills/requirements-writing/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.claude/skills/requirements-writing/`,把核对后的文件保存为 `.claude/skills/requirements-writing/SKILL.md`。
- 在该项目根目录启动 Claude Code,在斜杠菜单中选择 `/requirements-writing`。
中文摘要
从用户角色、目标和已知约束出发写用户故事、正常与异常场景,并给业务规则编号。
SKILL.md 中文导读
可复现示例
需求 req-09 是社区活动标题。已确认约束为标题最多 32 个字符,因此用 {limit: 32, validLength: 32, invalidLength: 33} 做边界案例。工作步骤
- 明确角色和任务目的,从已确认的限制推导正常与异常情况。
- 把每个结果写成可观察的条件,并给可复用的业务规则编号。
验收方法
两个可测试结果为 {length32: 'saved', length33: 'validation error'}。可为标题长度规则保留唯一编号,让实现和测试引用。
GitHub 原文 · 更新日期
适用环境
在 Claude Code 中打开 add-template 项目或采用相同的需求结构,准备现有需求和已确认的业务规则。
常见问题
什么样的验收条件能直接交给测试?
写出谁做什么、系统应显示或保存什么,并列出有意义的边界或异常条件。