适用于 Openclaw 的 Spec Coder 工作流

一个专业的设计文档优先(spec-first)开发框架,利用结构化的专家评审关卡,确保代码与技术需求完美契合。

xhuaustc
v0.1.4
2026年4月1日
0
939
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install spec-coder

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 spec-coder。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 Spec Coder 工作流?

Spec Coder 是为 Openclaw Skills 设计的一套精密开发工作流,它将架构完整性和需求清晰度置于无序的快速开发之上。通过实施从代码库扫描到演进的五个阶段生命周期,它确保 AI 智能体生成的每一行代码都根植于经过验证的设计规范中。

该技能将 AI 从简单的代码生成器转变为纪律严明的工程合作伙伴。它采用基于主干的文档策略,系统事实维护在核心规范文件中,而增量功能则在隔离的变更目录中开发。这种方法最大限度地减少了技术债务,并确保复杂的、多模块系统在演进过程中保持可维护性。

Spec Coder 工作流 应用场景

  • 构建需要严格架构监督的新功能或全新项目。
  • 扩展手动文档与代码同步已变得困难的现有代码库。
  • 实现需要多角色专家评审(需求、设计和代码)的复杂业务逻辑。
  • 使用 Openclaw Skills 并希望通过严格的“规范到代码”追溯性来减少 AI 幻觉的团队。

Spec Coder 工作流 工作原理

  1. 扫描现有代码库以建立技术上下文并识别架构惯例。
  2. 通过交互式过程澄清和确定需求范围,形成结构化的需求文档。
  3. 创建技术设计和低保真 HTML 预览,在开始编码前验证用户流程和系统架构。
  4. 将设计分解为粒度化的任务和具有明确测试点的功能规范。
  5. 并行生成实现代码和测试,严格遵守定义的规范并记录任何差距。
  6. 通过动态构建检查、lint 检查和单元测试验证输出,确保 100% 符合规范。

Spec Coder 工作流 配置指南

要在您的环境中初始化 Spec Coder 工作流,请确保您的项目结构包含一个 specs/ 目录。您可以通过使用规范优先命令调用智能体来开始该过程。

# 初始化新的规范驱动会话
# 智能体将自动寻找 specs/status.md
mkdir -p specs/changes/archive
touch specs/status.md

确保在您的 references/ 文件夹中可以访问相关的参考协议(专家评审、UI 指南),以启用 Openclaw Skills 的完整关卡评审功能。

Spec Coder 工作流 数据架构与分类体系

Spec Coder 使用分层的主干与分支模型组织数据,以管理项目的生命周期:

目录/文件 描述
specs/index.md 导航中心,追踪所有功能和最近的变更。
specs/status.md 当前阶段、关卡结果和代码库上下文的持久层。
specs/tasks.md 带有状态(待处理、进行中、已完成)的活动实现追踪。
specs/changes/ 用于进行中功能的隔离目录(例如 FEAT-001/)。
specs/spec_*.md 特定功能的真实来源,包括接口和测试点。

Spec Coder 工作流 高级特性

  • 多角色专家评审关卡:在进入下一阶段前自动检查严重或重大问题的自动化关卡。
  • 规范-代码追溯性:在代码中自动插入 TASK-ID 和 TP-ID 注释,将实现链接回原始规范。
  • 任务复杂度分流:在小型、中型和大型路径之间动态切换,平衡速度与严谨的文档记录。
  • 设计预览系统:自动生成独立的 HTML 原型,在编写生产代码前可视化 UI/UX。
  • 增量合并:高级阶段 5 逻辑,生成合并指令以更新主干规范,而不丢失历史上下文。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*