Claude Code + Spec-kit,组织四个 AI Agent 学会自己协作

告别需求文档焦虑:用Spec-Kit + Claude Code,5分钟搞定你的C++五子棋项目规划 本文介绍如何利用Spec-Kit和Claude Code工具组合,快速完成C++五子棋项目的规划与开发。通过规格驱动开发(Specification-Driven Development)方法,将自然语言需求自动转化为结构化文档和技术方案,大幅提升开发效率。文章详细演示了从环境配置到任务拆解的全流程,并分享五子棋项目中的实用避坑技巧。 阅读详情

思想的来源

BandCompany是我设想的一家软甲公司,前面学了Spec-kit之后,我就想让4个Agent,每个Agent负责流程中的一个节点,通过md文件记录任务状态。我设计的流程是:人类提需求,AI负责写规格、做计划、拆任务、写代码。每个步骤都有对应的 Claude 命令。试着和Claude Code沟通了我的想法,并一步一步实现。
本文的主要内容是记录我的过程,对于AI产出的流程、代码,并没有过多涉及。只要掌握思想,以及合理的使用Claude Code的方法,你也可以创造出一个多智能体的协作流程。

设计主流程,然后交给Claude来实现

先设计了流程:四个 Agent 通过 Markdown 文件传递任务,一个做完写入下一个的队列,像流水线一样。然后Claude开始创建文件——prompt 文件、队列文件、子智能体注册表、通信协议、Agent 定义,一口气写了十几个。

第一轮:脚本跑不起来

写了启动脚本 start-all.cmd,用户跑了一下,直接报错——Windows 上应该用 PowerShell,不是 CMD。

全部推翻,用 .ps1 重写。

第二轮:参数不存在

PowerShell 版 start-all.ps1 用 Start-Process -WindowTitle 给窗口加标题,报错——这个参数压根不存在。改成 cmd /c start "标题" pwsh ...,借用 Windows 的 start 命令创建窗口。

第三轮:启动了,但 prompt 文件找不到

窗口弹出来了,但立刻报 Prompt file not found。start-agent.ps1 被 cmd /c start 启动后,$MyInvocation.MyCommand.Path 是空的,算不出自己的目录。加了 $PSScriptRoot fallback 才定位到文件。

接着发现 implement-prompt.md 和 implementer-prompt.md 差两个字母——Agent 名是 implementer,文件名只写了 implement。

第四轮:四个窗口都就绪了,提交任务

用户在 specify.md 里加了一行:

- [ ] 做一个公司官网,宣传我们的AI智能体产品

四个窗口开始轮询。

第五轮:日志说完成了,但什么都没发生

Specifier 窗口日志显示 Task completed,但 specs/ 目录里空空如也,队列文件里的任务原封不动。

claude -p 在非交互模式下,工具调用被权限系统静默拦截了。Claude 输出了文字说"我已创建规格",实际上什么文件都没写。

加了 --dangerously-skip-permissions。

第六轮:Claude 说"请批准"

Claude 终于开始执行工具了,但输出了这样一段话:

“我需要你的批准才能继续。正在挂起的操作是:创建 git 分支、创建规范目录、更新队列文件”

没有人在窗口前审批。Agent 在等一个不存在的人。

在 prompt 开头加了:“直接使用工具执行,不要请求批准”。同时创建了项目级 .claude/settings.json 预授权所有工具。

第七轮:窗口一片空白

Agent 确实在跑,但窗口里什么都看不到。用 Get-Content prompt.md | claude 这种 stdin 管道方式,claude 进入非交互模式,输出不显示在终端。

改成把 prompt 作为命令行参数传入:claude $Prompt。窗口里终于能看到工具调用的实时过程了。

第八轮:跑起来了,但太频繁

四个 Agent 同时以 30 秒间隔轮询,API 调用频率爆炸。启动瞬间四连发冲击服务器,空闲时空跑几百次。

第九轮:Cron 调度

从 Bash sleep 轮询改成 CronCreate 定时触发,四个 Agent 错开 10 分钟:Specifier 每小时整点,Planner 每小时 :10,Tasker :20,Implementer :30。每个 Agent 处理完后注册下一次触发,空闲时挂起不消耗调用。

现在的样子

.\agents\start-all.ps1    # 启动
.\agents\status.ps1       # 查看状态
.\agents\stop-all.ps1     # 停止

提交任务:编辑 agents\queue\specify.md,加一行 - [ ] 需求描述。

流程思想很简单——四个 Agent 通过文件队列接力,每个做完写入下一个的队列,错开时间执行,避免并发。但让这个简单流程真正跑起来,花了九轮调试。

踩过的坑

问题原因
CMD 脚本报错应该用 PowerShell
Start-Process -WindowTitle 不存在这个参数不存在
脚本找不到 prompt 文件cmd 启动下路径变量为空
文件名差两个字母implement vs implementer
日志显示完成但实际没做claude -p 非交互模式工具被拦截
Agent 输出"请批准"模型在请求不存在的人类审批者
窗口空白stdin 管道触发非交互模式
API 调用爆炸30 秒轮询 × 4 进程
SDD选型指南:OpenSpec与Spec Kit的契约哲学对比 Specification-Driven Development(SDD)正从开发实践升级为系统级协作范式,其核心是将需求、接口、行为与测试统一为可执行契约。SDD的实现依赖于结构化规约语言与工具链协同,其中OpenSpec以YAML为载体,强调编译期强校验、跨域语义一致性与硬件级集成能力;Spec Kit则以AGENTS.md为枢纽,依托Markdown+指令块实现人机协同、实时可视化与敏捷对齐。二者分别支撑‘契约即代码’与‘文档即界面’两种技术价值路径,在车规安全、AI Agent编排、嵌入式仿真等场景 阅读详情

相关推荐

Claude Opus 4.6与Claude Code协同实践:Spec Coding工程落地指南

Spec Coding是一种以规格文档为驱动的AI编程范式,强调需求可验证、实现可追溯、变更可审计。其核心原理在于将模糊意图转化为结构化约束(如requirements.md),再通过大模型的上下文理解与角色化协作(Agent Teams)实现精准生成。该方法显著提升代码一致性与长期可维护性,技术价值体现在规避Vibe Coding导致的隐性技术债、强化团队知识沉淀、支撑规模化AI协作。典型应用场景包括中大型前端/全栈项目重构、企业级CI/CD质量门禁集成、以及开源组件库的跨主题功能演进。本文基于Claud

a4512138的专栏 477

Spec-Kit + Claude Code:规格驱动AI编程工程化实战

传统AI编程存在“氛围编码”问题——仅凭自然语言描述生成代码,结果看似正确,实际运行报错、逻辑混乱、缺乏规范、难以迭代。本文介绍GitHub开源的**Spec-Kit**工具,结合Claude Code实现规格驱动开发(Spec-Driven Development),通过“需求标准化→技术规划→任务拆解→全自动编码”的工程化流程,提升AI生成代码的质量与可维护性。

weixin_67327688的博客 1021

Speckit 和 Claude 使用指南

摘要:Speckit与Claude协同构建AI全链路研发体系,形成"AI为主、人为辅助"的开发模式。Speckit负责需求分析、任务拆解等流程性工作,ClaudeCode执行具体编码任务。系统支持从需求定义到代码实现的全流程协同,包括用户故事共创、技术规划、任务拆分等环节,通过规范的Git分支管理和上下文压缩机制保障开发效率。配置方面支持中英文环境切换和多人协作,提供完整的安装指南和操作流程,使AI能够深度参与软件开发全生命周期。

风起云涌 2282

Spec Kit AI编程规范全指南

Spec Kit 是 GitHub 官方开源的规范驱动开发工具包,它彻底颠覆了传统的开发流程:传统开发中,代码是核心,规范只是写完代码后被丢弃的脚手架;而在 Spec Kit 的理念里,规范是源头,代码只是规范的可执行实现。它的核心逻辑非常简单:先通过标准化的文档明确 “要做什么、要遵循什么规则”,再让 AI 严格按照这些规范来生成代码。这样一来,AI 就不会再 “自由发挥”,而是完全在我们设定的框架内工作,从根本上解决了 AI 编程的不可控问题。

篮球界最会写bug的人;程序猿中打球最菜的人。 583

如何从零开始写小程序

看了这篇文章,即使让我现在就从头写一个能够正常运行的小程序,也没有原本想象中的那么难了。 在本文中,我们将会以一个具体的小程序为例,带领大家从零到一完成一个小程序的开发流程,并将这个小程序上传到 FinClip.com 进行小程序提审与上架操作。 我们新建了一个叫做「HelloWorld」的小程序,FIDE 在初始化小程序项目时,会自动在项目目录中补充对应所需要的项目文件。那不妨让我们先从小程序目录下的配置文件开始,逐渐揭开小程序的面纱。 使用 FIDE 编辑小程序 1. 认识 json 文件 在小程序项目

POHOU23的博客 4398

Omnibox 2.11 NAS部署指南:家庭影音中枢的轻量化落地实践

家庭影音平台本质是本地化内容调度中枢,其核心在于聚合NAS媒体库、统一管理直播/IPTV/音频/视频等多源内容,并通过智能元数据匹配与硬解加速实现零门槛播放体验。技术原理上依赖Java轻量Web容器(Jetty)、SQLite嵌入式数据库双缓存架构,以及宿主机FFmpeg动态链接与HTTP/2直播代理治理能力。该方案显著降低4K播放卡顿、EPG加载失败、海报缺失等高频问题,适用于群晖、飞牛、绿联等主流NAS设备,尤其适配ARM64芯片与Realtek网卡等国产硬件生态。本文聚焦Omnibox 2.11在真实

weixin_30846347的博客 473

Spec-Kit 使用指南

Spec-Kit是 GitHub 官方开源的规范驱动开发工具包,旨在改变传统的 AI 编码方式。官方仓库支持的 AI 工具: Claude Code、GitHub Copilot、Cursor、Gemini CLI、Windsurf 等Spec-Kit 的核心价值从 “Vibe Coding” 到 “Spec-Driven”:让 AI 编码更可控规范即合约:AI 必须遵循规范,减少沟通成本结构化流程:每个阶段有明确输出,可追溯质量门禁:在实现前发现问题,减少返工推荐使用场景复杂业务功能开发。

IT界的奇葩 3428

Android逆向实战:抖音聊天记录数据库解析与导出(附完整SQL查询)

本文提供了一份Android逆向实战指南,详细解析了抖音聊天记录数据库的结构与导出方法。通过定位核心的`im.db`数据库文件,深度解读conversation_list、msg等关键表结构,并附上完整的SQL查询语句,帮助开发者或研究人员安全、合规地提取和分析本地聊天数据,适用于移动安全研究与数据分析场景。

mango的博客 867

Claude Code + Spec-kit:用 Markdown 编排四个 AI Agent 的协作骨架

用 Markdown 文件队列把 Claude Code 拆成 Specifier、Planner、Tasker、Implementer 四个 AI Agent,靠 PowerShell 错开定时触发接力协作。本文给出可复制的 registry、protocol、prompt 与启动脚本,并统一走 TaoToken 通道注入环境变量,附一次完整验证与常见报错排查。详见 https://taotoken.net/?utm_source=taotoken_aicg_blog_end

weixin_42598278的博客 48

ollama服务暴露公网?三步搞定Nginx反向代理配置(避坑指南)

本文详细介绍了如何通过Nginx反向代理安全地将Ollama服务暴露到公网,避免直接修改OLLAMA_HOST带来的安全隐患。文章提供了从SSL证书部署到高级安全加固的全流程实战指南,包括IP白名单、基础认证、速率限制等企业级安全措施,帮助用户实现安全可靠的外部访问。

wood5的博客 179

数据挖掘实战-基于决策树算法构建北京市空气质量预测模型

通过分析这些数据,我们将利用决策树算法建立预测模型。决策树算法具有直观易懂、分类效果好等优点,适合用于此类预测问题。我们将采用适当的方法对模型进行训练和优化,以提高预测精度。最终,我们将评估模型的预测效果,并探讨其在实际应用中的可行性和潜在价值。希望通过本实验,能为北京市的空气质量改善工作提供一定的支持。通过基于决策树算法构建的北京市空气质量预测模型的实验研究,我们在多方面取得了显著的进展。首先,我们成功地整合了来自气象、环保、交通等多个领域的大量数据,形成了一个全面而综合的空气质量分析框架。

m0_64336780的博客 2万+

AI工程化开发Agent - Spec-kit 介绍

Spec Kit 是先进的规范驱动开发(SDD)AI 工具包,核心理念是让软件规范成为项目唯一可信源头。它打破传统 “代码即文档” 或文档滞后模式,深度集成 Claude Code 等 AI 编程助手,能将结构化自然语言规范转化为高质量可执行代码。

heiyeluren的blog(黑夜路人的开源世界) 3568

医疗AI知识库更新慢?提示工程架构师用Agentic AI自动更新的策略

我们的目标是用Agentic AI替代传统更新流程中的“重复劳动”,让医疗知识库(以知识图谱为例)能自动跟踪最新医学进展,把“更新周期从数月缩短到数天”。从PubMed/指南数据库自动抓取新文献;用提示工程从文本中提取结构化医学知识;自动校验新知识与旧知识的冲突;将通过校验的知识写入知识图谱。拆问题:先讲医疗知识库更新慢的3大根源;给方案:用Agentic AI设计4个“小助手”解决问题;讲原理:每个小助手的工作逻辑+提示工程技巧;做实战。

AI 原生应用开发的博客 1063

Spec-Kit 详解:概念澄清与 Claude Code 整合实战

文章摘要 本文系统梳理了Claude Code生态中的核心概念和工具链,重点解析了Spec-Kit方法论。内容分为两部分: 概念地图:从来源和功能两个维度分类Claude Code相关概念,区分了内置功能、oh-my-claudecode框架和Spec-Kit工具包的不同定位,并通过速查表对比关键概念。 Spec-Kit方法论:强调通过强制文档化流程(spec→plan→tasks→implement)解决Vibe Coding的随意性问题,提供完整的安装和初始化指南。核心主张是将"想清楚"转化为可执行的文

摸鱼同学的博客 313

2025年9月GESP(C++四级):排兵布阵

作为将军,你自然需要合理地排兵布阵。地图可以视为n行m列的网格,适合排兵的网格以 1 标注,不适合排兵的网格以 0 标注。现在你需要在地图上选择一个矩形区域排兵,这个矩形区域内不能包含不适合排兵的网格。请问可选择的矩形区域最多能包含多少网格?

王老师青少年编程 1387

基于Slim-Neck架构的YOLOv11轻量化特征融合方案(实现超轻量级与高精度的双重突破)

购买即可解锁800+YOLO优化文章,并且还有海量深度学习复现项目,价格仅需两杯奶茶的钱,每日更新。

m0_64661770的博客 251

构建智能编码工作流:Spec-Kit、Superpowers与Claude Code的集成实践

在软件开发领域,自动化工作流和AI辅助编程正成为提升效率的关键技术。其核心原理在于通过工具链集成,将需求分析、代码生成与环境执行等环节串联,形成闭环反馈系统。这种集成方案的技术价值在于,它能将开发者从重复性任务中解放,实现从自然语言需求到可运行代码的自动化转换。典型的应用场景包括快速原型开发、标准化模块实现以及技术探索验证。本文以Spec-Kit、Superpowers和Claude Code的集成为例,展示如何构建一个具备需求解析、安全执行和智能编码能力的智能开发Agent,其中Superpowers作为

weixin_30291791的博客 422

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

Spec-kit配置及使用

记录spec-kit的配置和使用方法,便于之后使用参考 Spec Coding(规范驱动开发,Spec-Driven Development,简称 SDD)是一种新兴的 AI 辅助开发方法论,强调在编写代码之前先建立清晰、结构化的规范文档,然后让 Coding Agent 基于这些规范生成代码。

2302_78760365的博客 936

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

pscad IEEE标准系统搭建说明

pscad IEEE标准系统搭建说明,包含典型的IEEE 9节点、14节点、30节点、39节点和118节点系统。内含标准测试系统的原始数据和潮流结果。

Spec Kit agent-context 扩展深度解析:如何让 CLAUDE.md、AGENTS.md 与 Plan 自动保持同步

Spec Kit 的 `agent-context` 扩展负责管理编码智能体(Claude Code、Copilot、Cursor、Gemini 等)的上下文/指令文件,例如 `CLAUDE.md`、`AGENTS.md`、`.github/copilot-instructions.md`。它是一个**显式安装(opt-in)的可选扩展**:安装后,它会在这些文件中维护一段由可配置标记包围的"受管

gitblog_00675的博客 934

STM32F407中文手册

STM32f407中文手册 本参考手册面向应用开发人员,提供有关使用 STM32F405xx/07xx、STM32F415xx/17xx、 STM32F42xxx 和 STM32F43xxx 微控制器存储器与外设的完整信息。STM32F405xx/07xx、STM32F415xx/17xx、STM32F42xxx 和 STM32F43xxx 构成一个微 控制器系列,各产品具有不同的存储器大小、封装和外设。有关订购信息以及器件的机械与电气特性,请参见数据手册。有关 ARM Cortex™-M4F 内核的信息,请参见《Cortex™-M4F 技术参考手册》。

Claude Code 实战:Spec-Kit、Kiro、OpenSpec 规范驱动开发三剑客配置 TaoToken 指南

Claude Code 规范驱动开发实战:用 TaoToken 统一 API 通道,一份 settings.json 打通 Spec-Kit、Kiro、OpenSpec 三套工具链。先 curl 验证 Key 与地址,再逐工具配置 config.toml 与 AGENTS.md,最后按五步验证调用链路。官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end

weixin_35728286的博客 177

Spec Coding with Claude Code in Easy-Vibe: From Vibe Coding to Specifications as the New Source Code

Spec Coding(规格驱动开发)是 2025 年 AI 编程领域最重要的方法论转向:不再让"代码"而是让"规格说明书(specification)"成为开发的核心产物,AI 从规格中生成实现。本文以 easy-vibe 课程 Stage 3 核心技能章节 [spec-coding/index.md](https://link.gitcode.com/i/abec4a4a2cc086e14a1

gitblog_00554的博客 717

11 万 Star 的 Spec Kit,90% 的工程师只用它解决了 10% 的问题:用 TaoToken 统一 Key 打通 spec.md 到 Claude Code 的完整链路

Spec Kit 的 spec.md 要真正驱动 Claude Code 生成代码,需先统一模型通道。本文给出 settings.json 与 config.toml 可复制骨架,用 TaoToken 收敛 Key,并附 curl 验证与 analyze 一致性检查,让 SDD 链路跑通。详见 https://taotoken.net/?utm_source=taotoken_aicg_blog_end

Ceshi01的博客 10

告别 Vibe Coding:用 GitHub Spec Kit 让 AI Agent 按规格写代码

AI 编码时代,“准”胜过“快”。规格驱动开发(Spec-driven development)通过结构化需求文档,将模糊意图转化为可验证的边界。GitHub Spec Kit 作为轻量通用工具,以 CLI + 模板形式融入工作流,支持 40+ AI 工具,实现从宪法、规格到验证的五步闭环。其核心价值在于:用可追溯的制品链确保代码精准落地,提升协作效率与交付质量。

core815的专栏 562

Claude Code + Spec-kit:用 PowerShell 编排四个 AI Agent 的协作分工

用 PowerShell 拉起四个 Claude Code 进程,以 Spec-kit 的 Markdown 文件队列接力,让 Specifier、Planner、Tasker、Implementer 各守边界、错峰调度。文中给出 registry.json 注册表、start-agent.ps1 编排脚本与 status.ps1 状态核对,并统一走 TaoToken 一个 Key 接入,附 401、local proxy failed、reading choices 等报错对照表。详见 https://t

weixin_42591908的博客 7

从 Vibe Coding 到 Spec Coding:在 easy-vibe 项目中用“规范即代码“重构 AI 编程工作流

> 「代码是意图的有损投影。」Code is a lossy projection of intent. > —— Sean Grove,OpenAI,AI Engineer World's Fair 2025 Spec Coding(规范驱动开发,Spec-Driven Development)正在成为 AI 编程时代的新范式:不再把"写代码"当作核心产出,而是把**写规范(spec)**当作

gitblog_00951的博客 962

Spec Kit 扩展生态指南:3 条命令上手

Spec Kit 把规范驱动开发从一套固定流程做成了可插拔的生态:核心负责"规范→计划→任务→实现"这条主线,社区目录里的 150 多个扩展则各补一段空档——架构治理、安全审查、Jira 同步、并行开发各占一角。对已经会用核心命令的人,会挑扩展、会装扩展,比背扩展清单更值钱。 ## 一、先搞清楚它怎么跑:核心命令与产出物 装好 specify CLI 后,`specify init` 在你的项

gitblog_00427的博客 745
上一篇: 从0开始基于Karpathy的理念搭建Wiki
下一篇: llama.cpp部署Gemma4-26B,并给Claude使用的经验
tinygone
博客等级 码龄13年 190粉丝 42原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值