s
Turns a Meegle work item into a verifiable SPEC.md before any code is written. Use when starting a new requirement, feature or change, when the user says /s, or when asked to write a spec, PRD or requ
SKILL.mdskills/s/SKILL.md
GitHub/s —— 需求 → SPEC.md
输入
需求的唯一来源是 Meegle 工作项。没有工作项时先运行 /pd,不要直接从聊天或会议纪要生成 SPEC。
- 装了飞书项目 CLI:直接读工作项(
meegle命令),拿标题、描述、验收标准、优先级、子任务。 - 没装:让用户贴工作项内容。
- 不许猜。 工作项里没写的,问;问不到的,写进 SPEC 的「待澄清」并停下来。
- 工作项应已经过
/bl或等价的人类排期,具有明确优先级和迭代;缺失时报告计划缺口,不替产品补排期。
同时读仓库现状:AGENTS.md、README.md、相关模块代码、docs/intent/。
SPEC 是在现有系统上的增量,不是凭空设计。
产出
SPEC.md(仓库根,或 docs/SPEC.md),结构:
# SPEC: <标题>
> Meegle: [PROJ-1234](<工作项链接>)
## 目标
<一句话:为谁解决什么问题。做完什么样算成功。>
## 可验证行为
- <每条都能写出对应的测试。「系统应该好用」不是行为。>
## 边界与非目标
- <明确不做什么。这是 /b 阶段防止范围蔓延的唯一依据。>
## 影响面
| 维度 | 影响 |
|---|---|
| 模块 / 接口 | |
| 数据 / 存储 | |
| 上下游 | |
## 待澄清
- <问题 → 谁能回答。空着比编好。>
规则
- 每条行为都要可测。 写不出测试的条目,要么细化,要么进「待澄清」。
- 边界和非目标不能省。 它比目标更能防止后面跑偏。
- 头部必须带工作项号和链接 —— 这是仓库与 Meegle 之间唯一的溯源锚点。
- 需求变更先改 Meegle,再更新 SPEC.md。 反过来两边立刻漂移。
- 这一步不写代码,也不改现有文件(除了新建 SPEC.md)。
- 产品设计描述产品行为,SPEC 将其转成可验证行为;不要在
/s重做产品需求或优先级判断。
何时进下一步
SPEC 里每条行为都可验证,边界写清楚了,「待澄清」为空或已确认可以带着风险开工。
然后跑 /p。
Red Flags
- 「待澄清」全空,但你其实是靠猜填满了 SPEC
- 验收标准是「性能良好」「体验流畅」这类没法验的话
- 影响面表格空着 —— 说明还没读代码就在写 SPEC
- SPEC 里出现实现细节(用哪个库、怎么分层)—— 那是
/p的事