Claude Project Template

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代码集成

🛠 安装

快速设置

1. 克隆模板：

git clone https://github.com/yourusername/claude-project-template.git
cd claude-project-template

1. 运行安装脚本：

./setup.sh

1. 按照提示配置项目

手动设置

1. 将模板复制到项目中：

cp -r claude-project-template/* your-project/

1. 更新环境变量：

cp .env.example .env
# Edit .env with your API keys

1. 配置MCP服务器：

# Copy config to Claude directory
cp claude_desktop_config.json ~/Library/Application\ Support/Claude/

1. 更新路径 .claude/settings.json

🔧 配置

环境变量

中的必需变量 .env:

• GITHUB_TOKEN：GitHub个人访问令牌
• CONTEXT7_API_KEY：Context7文档API
• PROJECT_PATH：项目的绝对路径

MCP服务器设置

1. 全局安装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

1. 更新 claude_desktop_config.json 与您的项目路径

1. 重新启动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

🤝 团队协作

标准化工作流程

1. 使用 /new-feature 用于一致的功能开发
2. 代理商确保代码质量和标准
3. 自动日志记录跟踪所有更改
4. 文档是自动生成的

最佳实践

• 保持 .claude/context/CLAUDE.md 更新
• 在应用更改之前审查代理输出
• 将项目文件夹用于复杂功能
• 提交 .claude 文件夹到版本控制

🔒 安全

• 永不承诺 .env 文件
• 对所有机密使用环境变量
• 钩子在执行前验证更改
• 检查生成的代码是否存在安全问题

📚 文档

代理文件

每个代理人都有详细的文件 .claude/agents/[agent-name].md

指挥文件

命令用法和示例 .claude/commands/[command-name].md

项目上下文

更新 .claude/context/CLAUDE.md 包含项目特定信息

🐛 故障排除

MCP服务器不工作

1. 检查服务器安装： npm list -g
2. 验证中的配置路径 claude_desktop_config.json
3. 重新启动Claude桌面应用程序

钩子未执行

1. 验证脚本权限： chmod +x .claude/hooks/*.sh
2. 检查路径 .claude/settings.json
3. 手动测试挂钩： .claude/hooks/[hook-name].sh

代理未响应

1. 检查代理文件是否存在于 .claude/agents/
2. 验证代理名称是否完全匹配
3. 查看克劳德的回复是否有错误

📈 路线图

• \[\]添加更多专业代理
• \[\]为特定框架创建项目模板
• \[\]添加自动化测试工作流
• \[\]与更多MCP服务器集成
• \[\]创建基于web的配置工具

🤝 贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 提交拉取请求

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🙏 致谢

• 克洛德AI由Anthropic
• MCP协议贡献者
• 开源社区

📞 支持

• GitHub问题：\[报告错误或请求功能\]
• 文档：\[完整文档网站\]
• 社区：\[不和谐/松弛频道\]

______________________________________________________________________

*内置于❤️ 适用于使用Claude AI的团队*