ChatGPT / AI新闻聚合

Spec-Kit 使用指南 什么是Spec-Kit？ Spec-Kit是GitHub开源的一个工具包，用于实现规格驱动开发（Spec-Driven Development）。它与AI编码工具（如GitHub Copilot、Claude Code、Gemini CLI）集成，帮助开发者构建更高质量的软件。 解决的核心痛点 ● "氛围编码"问题：传统AI编码中，你描述目标，得到代码块，但往往"看起来对，但实际不工作" ● 缺乏结构化流程：从想法到实现缺乏清晰的步骤和检查点 ● 质量不一致：生成的代码缺乏统一的质量标准和测试覆盖…

● 依赖关系：确认任务间的依赖关系

阶段4：Implement（实现）

目标：基于TDD原则实现代码

代码生成原则

让Claude生成代码时遵循：

● 必须先写测试（TDD原则）
● 获得测试批准后再生成实现代码
● 通过迭代测试和审查完善代码

Coding 实践

● 1.给AI的信息需要精简.
● 2.不允许AI随便生成文件.
● 3.前期用AI设计方案,再基于方案生成todo列表.
● 4.每个todo都要经过人工审核后,才能让AI实现这个todo.
● 5.每个todo任务修改后的文件都需要人工审核.
● 6.每次审核todo任务完成情况之后都要git push,防止修改错了可以回退.

与传统开发的区别

实际使用场景

1. 新功能开发：完整的四阶段流程，适合复杂功能开发
2. Bug修复：简化流程，重点关注测试和验证
3. 代码重构：先明确规格，再进行重构
4. API设计：详细的规格定义和测试用例
5. 团队协作：规格文档作为团队沟通的统一语言
6. 项目交接：完整的规格和文档便于项目移交

项目文件结构

使用Spec-Kit后，你的项目通常会包含：

my-project/
├── spec.md              # 项目规格文档
├── plan.md              # 技术实现计划
├── tasks.md             # 任务分解列表
├── tests/               # 测试文件
│   ├── unit/
│   ├── integration/
│   └── e2e/
├── src/                 # 源代码
├── docs/                # 项目文档
└── README.md           # 项目说明

故障排除

常见问题

1. /specify命令不可用

解决方案：

● 检查是否正确初始化了Spec-Kit
● 重新运行初始化命令
● 确认Claude Code版本兼容

2. 生成的规格不符合预期

解决方案：

● 使用更具体的描述
● 提供更多上下文信息
● 迭代修改，多次执行/specify

3. 技术计划不合理

解决方案：

● 在/plan命令中提供更详细的技术约束
● 明确现有技术栈和限制
● 手动修改生成的plan.md

4. 任务分解粒度不当

解决方案：

● 手动调整tasks.md中的任务粒度
● 合并过小的任务，分解过大的任务
● 明确任务间的依赖关系

性能优化

● 使用上下文优化命令减少重复加载： ● get-steering-context ● get-spec-context ● get-template-context

进阶技巧

1. 规格版本控制

为重要的规格变更创建版本标记：

## 版本历史
- v1.0: 基础用户注册功能
- v1.1: 添加社交登录支持
- v1.2: 增加多语言支持

2. 模板复用

为常见的项目类型创建规格模板：

● Web应用模板
● API服务模板
● 移动应用模板

3. 团队协作

● 建立规格审查流程
● 定期同步规格文档
● 使用规格作为团队沟通工具

总结

Spec-Kit通过引入规格驱动开发，将Claude Code从"聊天式编码工具"转变为"结构化软件开发伙伴"。它强调：

● 先思考，再编码
● 测试优先，质量保证
● 文档驱动，团队协作
● 迭代改进，持续优化

----------------------

本文档基于Spec-Kit官方文档和实践经验整理，如有疑问请参考官方GitHub仓库

via 掘金人工智能本月最热 (author: lizhongxuan)