关于 living-spec-consolidator
living-spec-consolidator 是用于维护产品当前功能规范的开发技能,面向版本收尾后的产品团队。它按功能领域更新规范和索引,并生成交接报告;要求先具备需求、代码审查报告及任务完成记录。
主要功能
- 01按功能领域识别受影响规范
- 02读取既有规范后追加或更新
- 03维护需求、数据模型与端点
- 04更新规范索引
- 05生成规范整合报告
适用场景
- 01版本收尾后同步产品功能规范
- 02将新功能要求归入对应领域
- 03汇总规范新增与更新情况
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nextstage-brasil/ skills --skill living-spec-consolidator安装后在 Claude Code 中输入/living-spec-consolidator确认已加载。
附带文件evals/evals.jsonreferences/domain-spec.template.md
详细介绍
实时规格整合器
将 {specs_root}/ 维护为产品当前功能的权威依据。
默认 {specs_root} = {product_root}/docs/specs/。
Harness 发现
参见 ../nextstage-harness/references/harness-discovery.md 和 ../nextstage-harness/references/artifact-layout.md。
调用时机
- 版本收尾工作流之后(代码审查后)
- 不得在该版本的
code-review-report.md存在之前调用
前置条件
{product_root}/docs/versions/{version_san}/requirements.md{product_root}/docs/versions/{version_san}/code-review-report.md{product_root}/docs/versions/{version_san}/execution-handoff.md(任务已完成)
工作流
1. 确定受影响的领域
将功能映射到规范领域(例如):
| 功能领域 | 领域文件 |
|---|---|
| 身份验证、登录、RBAC | auth.md |
| 用户、个人资料 | users.md |
| 计费 | billing.md |
| 通知 | notifications.md |
| 报告 | reports.md |
| 集成 | integrations.md |
| Agent / 图 | agent.md |
命名规则:使用英文、kebab-case 和单数形式(user-profile.md)。跨多个领域的功能需更新多份规格。
2. 按领域处理
如果 {specs_root}/{domain}.md 不存在: 使用 references/domain-spec.template.md 创建。
如果存在: 完整阅读;追加或更新,绝不盲目覆盖。
对每项相关功能:
- 添加或更新
### Requirement:块(使用 SHALL 表述并包含场景) - 当架构/API 变更时,更新
## Data model和## Endpoints - 追加
## Changelog条目:**{version_san}** — {ISO date}: {summary}
3. 更新 INDEX.md
创建或更新 {specs_root}/INDEX.md:
# Domain specs — {product_name}
| Domain | File | Last updated | Versions |
| ------ | -------------------- | ------------ | ------------- |
| auth | `docs/specs/auth.md` | {date} | {version_san} |
4. 整合报告
输出简短报告以便交接:
## Living specs updated
| Domain | Action | File |
...
Requirements added: N
Requirements updated: N
New specs: N
关键规则
- 规格内容使用英文
- 需求使用可验证的 SHALL 表述
- 修改现有规格前先阅读
- 规划协调器应在制定新版本需求前阅读
INDEX.md
相关技能
requirements-generator— 规划时读取实时规格code-reviewer— 前置审批
评论
支持 Markdown