AI TPK：以龙与地下城为灵感的 Claude Code 多智能体工具包

AI TPK是一个受龙与地下城（D&D）启发的Claude Code智能体工具包，通过D&D风格的角色分工实现代码规划、审查、调查和发布的自动化工作流。其核心理念为"代码即地下城"，将优秀开发团队与成功D&D冒险队伍的相似性（明确分工、协作沟通、应对突发状况）映射到软件开发场景，通过配置良好的AI工具帮助征服代码库挑战。项目名称中的TPK（Total Party Kill）虽原指D&D团灭，但在此象征分工明确的队伍能征服任何代码挑战。

在软件开发中，我们常以机械化术语描述工作，但AI TPK将开发过程想象为D&D冒险。其设计哲学源于观察：优秀开发团队与D&D队伍均需明确分工、有效协作、应对突发状况及策略规划。D&D典型队伍的角色（地下城主、战士、法师等）被映射到软件开发场景，形成独特智能体分工模式，每个智能体有明确职责、专长及协作方式，共同处理复杂开发任务。核心理念可概括为："正如准备充分的队伍能征服地下城，配置良好的AI工具能帮助征服代码库"，此类比提供清晰协作模式。

AI TPK定义十一个智能体角色，对应软件开发特定职能：

1. 地下城主：系统编排者，理解任务目标、协调协作、制定策略，不直接写代码，引导流程；
2. 寻路者：侦察规划师，分析代码库结构、依赖关系，生成架构图和路径说明；
3. 风险法师：安全专家，负责代码安全审查、依赖漏洞扫描、架构风险评估；
4. 询问兽：知识管理员，记录决策、维护文档、回答项目历史查询；
5. 羽笔：技术文档专家，转化技术决策为可读文档；
6. 铸匠：核心开发者，专注功能实现与代码编写；
7. 结斩者：技术债务清理专家，重构、简化逻辑、消除冗余；
8. 真相锤：测试质量专家，验证代码行为是否符合预期；
9. 毁灭者：破坏性测试专家，寻找边界情况与潜在崩溃点；
10. 风语者：沟通协调者，确保信息流动、跟踪任务状态；
11. 迹花：调试追踪专家，定位问题根源、分析日志堆栈。

技术架构：AI TPK构建于Claude Code之上，通过提示工程和工具配置实现多智能体协作。安装简单（克隆仓库运行install.sh），采用双作用域设计：

• 用户级作用域（~/.claude/）：同步所有代码仓库，提供一致全局体验；
• 项目级作用域（.claude/）：仅当前仓库，支持定制化配置。

工作流入口：将任务分为两类：

• 调查型任务：目标为理解/分析现有代码（如依赖分析、性能瓶颈查找），派遣寻路者、风险法师等；
• 建设型任务：目标为创建/修改代码（如实现API、修复bug），召集铸匠、结斩者等。

审查工作流：强制基线审查（羽笔、真相锤、结斩者执行，确保文档、测试、代码质量）+ 可选专家审查（依变更性质动态选择，如安全敏感代码触发风险法师审查）。

钩子系统：利用Claude Code钩子管理会话生命周期：

• SessionStart：初始化环境、加载配置；
• PermissionRequest：审批敏感操作；
• SubagentStop：整合结果、更新状态；
• Stop：生成摘要、记录决策。

MCP服务器集成：通过模型上下文协议集成外部工具（代码搜索、文档生成等），提供配置向导降低集成门槛。

使用场景：支撑完整开发工作流：

• 代码库探索：寻路者生成架构图、询问兽回答历史问题；
• 功能开发：地下城主协调铸匠编码、羽笔写文档、真相锤测试；
• 代码审查：风险法师扫描安全、结斩者检查异味、真相锤验证测试；
• Bug调查：迹花分析日志、风语者协调信息、毁灭者复现边界；
• 发布准备：羽笔检查文档、真相锤回归测试、风险法师安全审查。

社区生态：AI TPK采用MIT许可证开源，鼓励社区贡献，提供详细贡献指南（配置更新、智能体规范、开发环境设置）及完善文档（安装到高级使用、角色说明、工作流示例）。

启示：AI TPK代表人机协作新范式：通过角色分工和协作机制让专门化智能体共同工作，更接近人类团队模式，易理解调试。D&D隐喻不仅有趣，更提供经验证的协作框架（明确分工、沟通协议、应变能力）。未来将有更多类似项目探索人机协作最佳结合点，发挥人类创造力与AI效率优势。