Claude AI项目模板
一个全面的项目模板，供使用Claude AI的团队使用，通过预配置的AI代理、MCP服务器和自动化挂钩加速开发。
🚀 特性
- 9个专门的人工智能代理：为不同的开发角色预先配置代理
- MCP服务器集成：GitHub、文件系统和文档的即用型连接
- 自动化工作流程：Git挂钩用于安全检查、日志记录和操作
- 项目管理：内置任务跟踪和项目组织
- 团队协作：标准化结构，实现一致的团队发展
📦 包含什么
AI代理
api-data-architect：数据服务和API模式code-review-enforcer：自动代码质量检查database-migration-architect：数据库模式和迁移规划devops-deployment-specialist：CI/CD和基础设施documentation-architect：技术文档创建frontend-ui-expert：React和UI开发production-validator：生产准备检查tech-research-specialist：技术研究和评价testing-specialist：测试创建和覆盖
命令
/new-feature：结构化功能开发工作流程/new-project：项目初始化和设置
自动化挂钩
- 预执行：运行命令前的安全检查
- 执行后：记录和后续行动
- 文件编辑：警告和验证
- 会话管理：总结和清理
MCP服务器
- 剧作家：浏览器自动化和测试
- 背景7：文件检索
- GitHub：存储库管理
- 文件系统：本地文件操作
- 集成开发环境：VS代码集成
🛠 安装
快速设置
- 克隆模板：
git clone https://github.com/yourusername/claude-project-template.git
cd claude-project-template- 运行安装脚本：
./setup.sh- 按照提示配置项目
手动设置
- 将模板复制到项目中：
cp -r claude-project-template/* your-project/- 更新环境变量：
cp .env.example .env
# Edit .env with your API keys- 配置MCP服务器：
# Copy config to Claude directory
cp claude_desktop_config.json ~/Library/Application\ Support/Claude/- 更新路径
.claude/settings.json
🔧 配置
环境变量
中的必需变量 .env:
GITHUB_TOKEN：GitHub个人访问令牌CONTEXT7_API_KEY：Context7文档APIPROJECT_PATH：项目的绝对路径
MCP服务器设置
- 全局安装MCP服务器：
npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-github
npm install -g @upstash/mcp-server-context7
npm install -g @executeautomation/playwright-mcp-server
npm install -g mcp-server-vscode- 更新
claude_desktop_config.json与您的项目路径
- 重新启动Claude桌面应用程序
自定义代理
在中编辑代理文件 .claude/agents/ 要自定义行为：
# agent-name.md
Your custom instructions and context for this agent添加新命令
在中创建新命令文件 .claude/commands/:
# command-name.md
Instructions for Claude to execute this command📂 项目结构
your-project/
├── .claude/
│ ├── agents/ # AI agent configurations
│ ├── commands/ # Custom slash commands
│ ├── context/ # Project context files
│ ├── hooks/ # Automation scripts
│ ├── logs/ # Session logs
│ ├── Projects/ # Sub-project organization
│ └── settings.json # Claude configuration
├── .env # Environment variables
├── claude_desktop_config.json # MCP server config
└── [your project files]🎯 使用示例
启动新功能
Claude: /new-feature user-authentication代码审查
Claude: Please review the changes using the code-review-enforcer agent数据库迁移
Claude: Help me plan a database migration from SQLite to PostgreSQL文档
Claude: Generate API documentation for the auth module🤝 团队协作
标准化工作流程
- 使用
/new-feature用于一致的功能开发 - 代理商确保代码质量和标准
- 自动日志记录跟踪所有更改
- 文档是自动生成的
最佳实践
- 保持
.claude/context/CLAUDE.md更新 - 在应用更改之前审查代理输出
- 将项目文件夹用于复杂功能
- 提交
.claude文件夹到版本控制
🔒 安全
- 永不承诺
.env文件 - 对所有机密使用环境变量
- 钩子在执行前验证更改
- 检查生成的代码是否存在安全问题
📚 文档
代理文件
每个代理人都有详细的文件 .claude/agents/[agent-name].md
指挥文件
命令用法和示例 .claude/commands/[command-name].md
项目上下文
更新 .claude/context/CLAUDE.md 包含项目特定信息
🐛 故障排除
MCP服务器不工作
- 检查服务器安装：
npm list -g - 验证中的配置路径
claude_desktop_config.json - 重新启动Claude桌面应用程序
钩子未执行
- 验证脚本权限：
chmod +x .claude/hooks/*.sh - 检查路径
.claude/settings.json - 手动测试挂钩：
.claude/hooks/[hook-name].sh
代理未响应
- 检查代理文件是否存在于
.claude/agents/ - 验证代理名称是否完全匹配
- 查看克劳德的回复是否有错误
📈 路线图
- \[\]添加更多专业代理
- \[\]为特定框架创建项目模板
- \[\]添加自动化测试工作流
- \[\]与更多MCP服务器集成
- \[\]创建基于web的配置工具
🤝 贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 提交拉取请求
📄 许可证
MIT许可证-有关详细信息，请参阅许可证文件
🙏 致谢
- 克洛德AI由Anthropic
- MCP协议贡献者
- 开源社区
📞 支持
- GitHub问题：\[报告错误或请求功能\]
- 文档：\[完整文档网站\]
- 社区：\[不和谐/松弛频道\]
______________________________________________________________________
*内置于❤️ 适用于使用Claude AI的团队*