Claude Code Boilerplate Framework：AI原生开发工作流的完整模板导读

随着AI编程助手从代码补全工具演进为复杂任务智能体，开发者面临组织编排AI能力的挑战。本框架提供开箱即用的工作空间模板，将Claude Code转化为结构化AI驱动开发环境。核心价值在于WAT Framework（Workflows-Agents-Tools）三层架构，辅以预配置MCP服务器、技能系统、记忆管理等能力，帮助团队快速搭建AI协作开发流程。

项目定位与背景：不止是工具集合，更是方法论

本框架区别于普通AI工具集合，核心是其方法论。它定义WAT三层架构，明确人类、AI、代码的角色边界：AI专注协调决策，确定性执行交给代码。正如文档所述：“AI在5个步骤中以90%的准确率链接，最终成功率仅59%”，通过卸载执行到脚本，AI可聚焦更高层次编排。

WAT框架核心与项目结构

WAT三层架构

• Workflows：workflows/下的Markdown SOP，定义任务顺序、决策点、验收标准，是人类可读文档与AI指令源。
• Agents：Claude作为智能体，负责推理、协调、故障恢复，读取工作流并决定调用工具。
• Tools：tools/下的Python脚本，执行确定性操作（API调用、数据处理等），可复用。

项目结构

关键目录包括：

• .claude/：Claude配置（rules/、agents/、skills/等）
• tools/：执行脚本
• workflows/：Markdown SOP
• .mcp.json：MCP服务器定义
• .env：API密钥（忽略git） 每个目录设计均服务于AI辅助开发流程。

预配置能力：MCP服务器、技能系统与记忆管理

预配置MCP服务器

框架预配置13个MCP服务器，覆盖常见需求：

服务器	用途
memory	持久化知识图谱记忆
supabase-mcp	Postgres数据库操作
openrouter-mcp	多模型LLM路由
tavily-mcp	网络搜索与内容提取

技能系统

通过.claude/skills/下的Markdown文件创建自定义斜杠命令，内置技能如/frontend-design（前端开发入口）、/claude-api（脚手架搭建）、/simplify（代码审查）等。

记忆管理

通过文件系统解决上下文持续性：

文件	用途
memory-profile.md	用户角色背景
memory-preferences.md	用户偏好
memory-decisions.md	架构决策记录
memory-sessions.md	会话日志
要求实时更新，避免信息丢失。

规则系统与工作原则

规则系统

.claude/rules/下的.md文件会话开始时自动加载，定义行为准则：

• agent-instructions.md：WAT框架规范
• memory-guidelines.md：记忆更新规则
• frontend-instructions.md：前端标准

工作原则

1. 先查看再构建：优先检查tools/是否有现成工具
2. 向前失败：完整阅读错误，修复根本原因并更新工作流
3. 工作流演进：发现更好方法时更新workflows/，但不擅自覆盖
4. 不臆测：只构建任务所需功能，不添加额外特性
5. 云端即真相：最终输出存云服务，.tmp/为临时空间
6. 未经批准不部署：生产前确认本地自动化正常

适用场景与局限考量

适用场景

• AI原生开发团队：深度集成AI到开发流程
• 自动化工作流构建：Trigger.dev支持的后台任务
• 多MCP集成项目：同时集成数据库、搜索等服务
• 团队协作标准化：沉淀最佳实践为技能与规则

局限

• 学习曲线：WAT架构与结构有一定复杂度
• 现有项目集成：迁移需较大结构调整
• 工具依赖：深度依赖Trigger.dev等特定工具链

结语：AI辅助开发的方法论价值

Claude Code Boilerplate Framework代表AI辅助开发工具演进方向：从提供能力到提供组织能力的最佳实践。它不仅是配置集合，更是与AI有效协作的方法论。

对于探索AI智能体整合的团队，框架提供深思熟虑的起点。WAT架构、技能系统、记忆管理等设计，体现对AI辅助开发挑战的深刻理解。随着AI能力增强，组织编排能力将成关键，本框架是优秀的学习与实践平台。