mcpField
L
living-spec-consolidator

living-spec-consolidator

github.com/nextstage-brasil开发040 次安装4 天前更新
代码仓库

关于 living-spec-consolidator

living-spec-consolidator 是用于维护产品当前功能规范的开发技能,面向版本收尾后的产品团队。它按功能领域更新规范和索引,并生成交接报告;要求先具备需求、代码审查报告及任务完成记录。

主要功能

  1. 01按功能领域识别受影响规范
  2. 02读取既有规范后追加或更新
  3. 03维护需求、数据模型与端点
  4. 04更新规范索引
  5. 05生成规范整合报告

适用场景

  1. 01版本收尾后同步产品功能规范
  2. 02将新功能要求归入对应领域
  3. 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. 确定受影响的领域

将功能映射到规范领域(例如):

功能领域领域文件
身份验证、登录、RBACauth.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