SDD工具包
规范驱动开发（SDD）工具包 --使用Claude Code进行功能驱动开发的综合系统，包括31个MCP服务器、16个自主代理、52多种技能和结构化工作流的模板/脚本。
快速开始
# 1. Clone the repository
git clone
cd agents-and-skills
# 2. Set up Python virtual environment
source .venv/bin/activate
# 3. Install dependencies (already set up)
pip install -r requirements.txt
# 4. Start using SDD workflows
# See .claude/agents/README.md for agent usage包含什么
核心组件
- 16个自主代理 (
.claude/agents/)SDD工作流程各阶段的专业代理 - 52+技能 (
.claude/skills/)-通用开发任务的可重用功能 - 31台MCP服务器 (
src/mcp_servers/)基于Python的MCP服务器，用于专业集成 - SDD模板 (
.specify/templates/)-规范、计划、任务、ADR和PHR模板 - Bash脚本 (
.specify/scripts/bash/)-PHR、ADR和功能工作流的自动化 - 宪法 (
.specify/memory/constitution.md)-项目原则和质量门
SDD工作流程
该工具包遵循结构化的开发工作流程：
- 指定 (
/sp.specify)-创建功能规范 - 计划 (
/sp.plan)-制定技术实施计划 - 任务 (
/sp.tasks)-将计划分解为有序、可测试的任务 - 实施 (
/sp.implement)-使用TDD执行任务 - 审查 (
/sp.git.commit_pr)-提交并创建pull请求
支持工作流：
/sp.clarify-澄清未明确的要求/sp.analyze-验证跨工件一致性/sp.adr-记录架构决策/sp.phr-记录学习提示历史
项目结构
.
├── .claude/
│ ├── agents/ # Autonomous agents (sdd-*, github-workflow, etc.)
│ ├── skills/ # Reusable skills (TDD, mcp-builder, frontend-design, etc.)
│ └── mcp/ # MCP integration configs
├── .specify/
│ ├── memory/ # Constitution and project memory
│ ├── templates/ # Feature artifact templates
│ └── scripts/bash/ # Automation scripts
├── history/
│ ├── prompts/ # Prompt History Records (PHRs)
│ └── adr/ # Architecture Decision Records
├── specs/ # Feature specifications (organized by feature)
├── src/
│ └── mcp_servers/ # 31 MCP server implementations
├── CLAUDE.md # Claude Code runtime instructions
├── requirements.txt # Core Python dependencies
└── README.md # This file关键代理人
SDD核心工作流代理
- sdd指定 -从自然语言创建特征规范
- sdd计划 -技术规划和架构设计
- sdd任务 -使用依赖关系排序生成任务
- sdd实现 -TDD的实施执行
- sdd git提交pr -Git工作流程和PR创建
支持代理
- sdd澄清 -通过有针对性的问题澄清需求
- sdd分析 -跨工件一致性和质量验证
- sdd adr -架构决策记录创建
- sdd phr -快速创建学习历史记录
- sdd章程 -项目构成管理
- sdd检查表 -自定义验证清单生成
- sdd逆向工程师 -从现有代码中提取规格
- sdd任务问题 -将任务转换为GitHub问题
完整的代理文件： .claude/agents/README.md
MCP服务器
31台专用MCP服务器，涵盖：
- 后端：FastAPI、Django、SQLModel ORM、Neon DB
- 前端Next.js、Docusaurus、前端设计、主题工厂
- 开发运维：Docker、Kubernetes、Helm、Minikube、kubectl ai
- 测试：TDD、Webapp测试、质量执行者
- AI/ML：OpenAI代理SDK、OpenAI聊天工具包、即时工程师
- 发展：网页内容提取、PDF、PPTX、Pandas
- 社交：领英、推特、元社交
- 其他：Venv经理、代币管理员、面试准备、Xero会计
配置： .mcp.json
宪法
该项目遵循中定义的严格开发原则 .specify/memory/constitution.md:
- 规范驱动开发 -所有功能均以批准的规格开始
- 测试优先（TDD） -强制红绿重构周期
- 最小可行差异 -仅进行最低限度的必要更改
- 可追溯性 -所有通过工件（PHR、ADR）链接的工作
- 默认安全 -没有硬编码的秘密，在边界处验证
- 简单（YAGNI） -没有过早的抽象或复杂性
使用示例
创建新功能
# 1. Create specification
/sp.specify "Add user authentication with OAuth2"
# 2. Generate implementation plan
/sp.plan
# 3. Generate tasks
/sp.tasks
# 4. Execute implementation
/sp.implement
# 5. Commit and create PR
/sp.git.commit_pr "Complete user authentication"审查和分析
# Validate cross-artifact consistency
/sp.analyze
# Create architectural decision record
/sp.adr "jwt-vs-session-authentication"
# Generate custom security checklist
/sp.checklist "Create security validation checklist"依赖项
核心依赖项（安装在 .venv/):
mcp>=1.0.0 # FastMCP framework
pydantic>=2.0.0 # Data validation
httpx>=0.27.0 # Async HTTP client
pyyaml>=6.0.0 # YAML parsing
anthropic>=0.40.0 # Anthropic API client贡献
创建新组件时：
- 代理：遵循现有代理的结构，包括全面的AGENT.md
- 技能：使用
/skill-creator或/skill-creator-pro结构一致 - MCP服务器：遵循FastMCP模式，包括工具文档
- 模板：维护YAML frontmatter，使用一致的占位符
许可证
\[在此处添加您的许可证\]
支持
- 打开一个问题
- 看
.claude/agents/README.md获取详细的代理文档 - 检查
CLAUDE.md运行时开发指南