\ud83e\udd9e Spec Kit — 规格编写助手

v1.0.0

将功能描述转化为清晰、可测试的规格文档,自动生成用户故事、验收标准与成功指标,助您快速定义需求并衡量价值。

0· 22·1 当前·1 累计
下载技能包 项目主页
最后更新
2026/4/21
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
该技能的说明、文件与需求均与规格编写助手保持一致:仅含指令,不索取密钥或异常二进制,功能与目的相称。
评估建议
本技能仅为指令型,功能与目的相符。安装前:(1) 检查平台配置键 night-market.superpowers:brainstorming 的控制范围,确保未授予超出预期的权限;(2) 除非信任环境,勿输入敏感机密或专有文档;(3) 如需更严控制,可禁用该技能的自主调用或要求显式用户确认;(4) 如需额外保障,请验证插件主页/所有者以了解来源与更新。...
详细分析 ▾
用途与能力
名称与描述指向规格编写助手,SKILL.md 与模块文件内含模板、清单与模式均与此目的相符。唯一声明的配置依赖(night-market.superpowers:brainstorming)合理映射到平台功能开关,与所述功能无冲突。
指令范围
运行时指令仅涉及生成规格文本、模板与清单,未指示代理读取任意文件、访问环境变量、调用外部端点或收集无关系统数据。
安装机制
无安装规范与代码文件——仅为指令型,因此不会写入磁盘,也不下载外部包,属于最低风险安装模式。
凭证需求
技能无需环境变量或凭证。声明需配置路径(night-market.superpowers:brainstorming),可能引用平台功能开关,其具体范围取决于平台实现,授权前应了解清楚。
持久化与权限
always:false 且 user-invocable:true(默认)。允许模型自主调用(disable-model-invocation:false),为技能常规设置;未请求常驻或系统级配置变更。
安全有层次,运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/4/21

- 初始发布“规格编写”技能(版本 1.8.2)。 - 根据功能描述生成清晰、可测试的规格,聚焦用户故事与验收标准。 - 强调用户价值、业务需求与可衡量成功标准,避免实现细节。 - 提供结构化模板、清单与最佳实践示例,助力高效规格编写。 - 专用于规格创建、精炼与需求定义,而非任务或实施规划。

无害

安装命令

点击复制
官方npx clawhub@latest install nm-spec-kit-spec-writing
镜像加速npx clawhub@latest install nm-spec-kit-spec-writing --registry https://cn.longxiaskill.com

技能文档

Night Market Skill — 从 claude-night-market/spec-kit 移植。如需完整体验,包括 agents、hooks 和 commands,请安装 Claude Code 插件。

# 规范编写(Spec Writing)

概述

从自然语言的功能描述中创建清晰、完整且可测试的规范。规范聚焦于用户价值与业务需求,避免涉及实现细节。

何时使用

  • 创建新功能规范
  • 细化已有规范
  • 编写用户故事与验收标准
  • 定义成功指标

何时不使用

  • 生成实现任务 —— 请使用 task-planning

核心原则

聚焦用户价值与业务需求,而非实现细节。除非绝对必要,避免在需求定义中指定技术选型。确保每项需求均可测试、可验证,并具备可衡量标准。限制澄清标记;基于行业标准做出有依据的假设,并明确记录。

规范结构

必填章节

  • 概述/背景:解决什么问题?
  • 用户场景:谁使用、如何使用?
  • 功能需求:必须做什么?
  • 成功标准:如何确认其有效?

可选章节

  • 成功标准(性能/安全关键时)
  • 边界情况(需特殊处理时)
  • 依赖项(涉及外部系统时)
  • 假设(信息不完整时做出的决策)

参考modules/specification-structure.md 获取详细模板与指南

质量清单

  • [ ] 无实现细节
  • [ ] 需求可测试、无歧义
  • [ ] 成功标准可衡量
  • [ ] 用户场景覆盖主流程
  • [ ] 边界情况已识别
  • [ ] 范围清晰界定

成功标准速查

良好(聚焦用户、可衡量、技术无关)

  • “用户可在 3 分钟内完成结账”
  • “系统支持 10,000 并发用户”
  • “95% 的搜索在 1 秒内返回结果”

不佳(聚焦实现、内部指标)

  • “API 响应时间低于 200ms” → 改为:“页面在 2 秒内加载完成”
  • “Redis 缓存命中率高于 80%” → 改为:“常用数据加载无明显延迟”
  • “React 组件高效渲染” → 改为:“UI 更新无可见掉帧”

参考modules/success-criteria-patterns.md 获取详细示例与转换流程

相关技能

  • speckit-orchestrator:工作流协调
  • task-planning:将规范拆解为任务

故障排查

常见问题

若规范过于模糊,使用 success-criteria-patterns 模块强制可衡量结果。 若实现细节渗入规范,对照“核心原则”复查,并重构成聚焦用户行为。

数据来源ClawHub ↗ · 中文优化:龙虾技能库