# AI_PROJECT_TEMPLATE：面向多智能体开发的 AI 项目脚手架

> 一个基于 claudechic 的多智能体 AI 项目模板，提供环境管理、权限护栏、工作流编排等完整工具链，支持从单人到团队协作的 AI 辅助软件开发。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-11T17:45:48.000Z
- 最近活动: 2026-04-11T17:53:34.185Z
- 热度: 161.9
- 关键词: AI_PROJECT_TEMPLATE, claudechic, 多智能体, Claude Code, 工作流, 项目模板, MCP, copier, AI开发
- 页面链接: https://www.zingnex.cn/forum/thread/ai-project-template-ai
- Canonical: https://www.zingnex.cn/forum/thread/ai-project-template-ai
- Markdown 来源: ingested_event

---

# AI_PROJECT_TEMPLATE：面向多智能体开发的 AI 项目脚手架\n\n## 项目概述\n\nAI_PROJECT_TEMPLATE 是由 sprustonlab 开发的一套完整的 AI 项目脚手架模板，旨在解决使用 Claude Code 等 AI 辅助开发工具时的常见痛点：环境配置复杂、权限管理混乱、多智能体协作缺乏规范等。该项目基于 copier 模板引擎构建，提供一键式项目初始化，让用户能够快速搭建具备生产级配置的 AI 开发环境。\n\n项目的核心亮点在于其对"多智能体开发工作流"的深度支持。通过与 claudechic（一个围绕 Claude Code 构建的 TUI 包装器）集成，该模板提供了一套结构化的多智能体协作框架，让多个 AI 代理能够在明确的角色分工和阶段关卡下协同完成复杂开发任务。\n\n## 核心组件与架构\n\nAI_PROJECT_TEMPLATE 构建了一个完整的工具生态系统，涵盖从项目初始化到持续开发的各个环节：\n\n### 项目结构概览\n\n生成的项目采用清晰的分层目录结构：\n\n- **`.claude/`**：Claude Code 专用配置，包括斜杠命令和代理上下文规则文件\n- **`workflows/`**：工作流定义目录，包含多智能体团队工作流、教程工作流等\n- **`global/`**：全局配置，包括始终生效的项目规则和上下文提示\n- **`commands/`**：启动脚本，其中 `claudechic` 是主要入口\n- **`mcp_tools/`**：MCP（Model Context Protocol）工具插件目录\n- **`repos/`**：代码库目录，支持集成现有项目\n- **`envs/`**：环境配置目录\n\n### claudechic：多智能体 TUI 包装器\n\n项目的核心依赖是 claudechic，这是一个由 Matthew Rocklin（Dask 和 SymPy 的开发者）创建的 TUI（文本用户界面）工具。claudechic 在 Claude Code 之上提供了多项增强功能：\n\n**共享权限模式**：通过 Shift+Tab 循环切换的权限模式（default/edit/plan/bypass）会在所有代理和子代理间同步。这意味着当用户切换权限级别时，整个多智能体系统都会遵循相同的权限策略。\n\n**会话管理**：提供 `/clearui` 命令清理历史消息，当会话变得迟缓时恢复响应速度。虽然会丢失滚动历史，但能显著提升交互体验。\n\n**Yolo 模式**：通过 `--yolo` 参数启动时，bypass 模式允许代理执行任意命令，适合在受控环境中使用。\n\n### 基于规则的权限系统\n\n项目内置了多层次的权限护栏机制，在运行时由 claudechic 处理：\n\n**Guardrail 规则**：始终激活的基础安全规则，阻止危险操作如 `rm -rf /` 和 `git push --force`\n\n**全局规则**：定义在 `global/rules.yaml` 中，对整个项目生效的额外约束\n\n**工作流规则**：特定于某个工作流的规则，定义在工作流的 YAML 配置中\n\n这种分层设计允许在不同粒度上控制 AI 代理的行为能力，既保证了安全性，又保留了灵活性。\n\n## 多智能体工作流：project-team\n\nAI_PROJECT_TEMPLATE 最具特色的功能是其结构化的多智能体协作工作流。通过输入 `/project-team` 命令，用户可以启动一个分阶段的多代理开发流程：\n\n### 阶段一：愿景（Vision）\n\n用户描述想要构建的内容，专门的代理负责澄清需求并确认理解。这个阶段确保所有参与者对目标有共同的理解，避免后续开发中的方向性偏差。\n\n### 阶段二：规范（Specification）\n\n由领导型代理团队负责起草详细规范：\n\n- **Composability（可组合性）**：确保设计的模块化和可复用性\n- **Terminology（术语）**：统一项目中使用的概念和命名\n- **UserAlignment（用户对齐）**：验证设计是否符合用户需求\n- **Skeptic（质疑者）**：主动寻找设计中的潜在问题和风险\n\n这些代理不是直接编写代码，而是产出高质量的规范文档，为后续实现提供清晰指导。\n\n### 阶段三：实现（Implementation）\n\n实现者代理根据规范编写代码，整个过程在领导型代理的指导下进行。这种"领导-执行"的分层结构确保了代码质量的同时，也保持了开发效率。\n\n### 阶段四：测试（Testing）\n\n编写并运行测试，由领导型代理进行审核和签字确认。每个阶段都设有用户检查点，确保人类开发者始终掌握项目进展。\n\n## 快速开始与安装\n\n项目提供了多种安装方式，适应不同的使用场景：\n\n### 一键安装\n\n项目网站提供了针对 Linux、macOS 和 Windows 的单行安装命令，复制粘贴即可快速启动。\n\n### 基于 Pixi 的安装\n\n对于已安装 pixi（一个现代化的 Python 包管理器）的用户，可以使用以下命令：\n\n```bash\npixi exec --spec \"copier>=9,<10\" --spec git -- copier copy --trust https://github.com/sprustonlab/AI_PROJECT_TEMPLATE my-project\ncd my-project && pixi install\n```\n\n### 配置选项\n\n安装过程中会询问一系列配置选项：\n\n- **project_name**：项目名称，同时作为目录名和 pixi 环境名\n- **quick_start**：示例内容级别（完整/默认/空白/自定义）\n- **target_platform**：目标操作系统\n- **claudechic_mode**：标准模式（git URL）或开发者模式（本地可编辑）\n- **use_cluster**：是否启用 HPC 作业管理（LSF 或 SLURM）\n- **init_git**：是否初始化 git 仓库\n- **existing_codebase**：是否集成现有代码库\n\n## MCP 工具与扩展性\n\n项目支持 MCP（Model Context Protocol）工具插件，只需将 Python 文件放入 `mcp_tools/` 目录，claudechic 就会自动发现并加载。这种设计使得扩展项目功能变得异常简单。\n\n模板内置了对 LSF 和 SLURM 集群后端的支持，方便在 HPC 环境中管理 AI 训练作业。\n\n## 开发者模式与项目定制\n\n在开发者模式下（`claudechic_mode=developer`），生成的项目包含 `.claude/rules/*.md` 文件。这些是 Claude Code 原生的代理上下文文件，当代理处理匹配特定 glob 模式的文件时会自动加载。它们记录了 claudechic 内部机制（提示、检查、护栏、工作流、清单 YAML）的文档，与上述的护栏引擎和规则系统是不同的概念。\n\n模板本身使用 copier 进行版本管理，支持通过 `copier update` 命令更新到最新版本，同时保留用户的自定义修改。\n\n## 应用场景与价值\n\nAI_PROJECT_TEMPLATE 适用于多种开发场景：\n\n**个人项目**：为个人开发者提供开箱即用的 AI 辅助开发环境，无需手动配置复杂的工具链\n\n**团队协作**：标准化的项目结构和多智能体工作流，降低团队成员之间的协作摩擦\n\n**教育训练**：作为学习 AI 辅助开发的教学模板，展示最佳实践和工具组合\n\n**研究项目**：内置的 HPC 支持和实验管理功能，适合学术研究使用\n\n**企业应用**：权限护栏和审计日志功能满足企业级安全合规要求\n\n## 技术亮点与创新\n\n**声明式工作流**：通过 YAML 文件定义多智能体协作流程，而非硬编码在代码中\n\n**上下文感知提示**：hints 系统根据当前工作流阶段和代理角色，动态显示相关提示信息\n\n**阶段关卡检查**：advance checks 机制确保只有在满足特定条件时才能进入下一阶段\n\n**会话快照**：chicsessions 支持保存和恢复多智能体会话状态，便于长时间任务的断续执行\n\n## 总结\n\nAI_PROJECT_TEMPLATE 代表了 AI 辅助开发工具链的成熟化趋势。它不再满足于简单的"让 AI 写代码"，而是构建了一套完整的工程化框架，涵盖环境管理、权限控制、协作流程等多个维度。对于希望将 AI 工具正式纳入开发工作流的团队和个人，这个模板提供了一个坚实且经过深思熟虑的起点。