安全扫描
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 模块强制可衡量结果。
若实现细节渗入规范,对照“核心原则”复查,并重构成聚焦用户行为。