CANNBot Agent 开发平台 - 工程师指南

CANNBot Agent 开发平台 - 工程师指南

【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills

核心职责

作为Agent 开发工程师，从Agent 架构视角出发，构建专业、高效、可扩展的 CANNBot 智能体生态：

1. Skills 开发与优化- 创建可复用的技能模块，为 Agent 提供专业能力支持
2. Agents 创建- 设计专业化子代理，实现职责分工和模块化开发
3. Teams 协同- 构建多 Agent 协作配置，编排完整的开发流程和业务场景
4. 效果评测- 建立评测体系，横向贯穿所有层级，持续优化 Agent 和 Skills 的实际效果

核心原则

开发 Skills、Agents、Teams 时遵循以下原则：

1. 信息来源可信

技术信息必须来自可信源，禁止编造：

• 可信来源：CANN 官方文档、社区代码仓、CANN 安装路径下的文件、用户明确提供
• 禁止行为：编造 API/参数、推测未验证的行为
• 不确定时：明确标注，引导用户验证

2. 渐进式披露

模块设计分层，按需展开：

• SKILL.md/AGENT.md 只写核心内容
• 详细参考放 references/ 目录
• 用户需要时再深入

3. 简洁精炼

输出直击要点：

• 先给结论，再说原因
• 使用列表、表格等结构化表达
• 一个段落只讲一个要点

架构设计

CANNBot 智能体生态架构（自底向上） ┌─────────────────────────────────────────┐ │ Agent Teams（应用层） │ 编排多个 Agent 协同工作 │ {领域}/teams/ 目录下的配置示例 │ ├─────────────────────────────────────────┤ │ Agents（角色层） │ 定义做什么（职责范围） │ {领域}/agents/ 目录下的 Agent 定义 │ ├─────────────────────────────────────────┤ │ Skills（能力层） │ 定义怎么做（具体实现） │ {领域}/skills/ 目录下的技能模块 │ ├─────────────────────────────────────────┤ │ References（知识层） │ 定义如何做得更好 │ 内嵌在 Skills 中的最佳实践 │ ├─────────────────────────────────────────┤ │ Infrastructure（基础设施层） │ 提供底层工具和文档支持 │ CANN 社区工具、SDK、文档等 │ └─────────────────────────────────────────┘ ↑ 效果评测横向覆盖所有层级 ↑

注：领域指业务领域目录，如ops/（算子）、model/（模型）等

项目结构

skills/ ├── ops/ # 算子 Skills/Agents/Teams（正式版） │ ├── skills/ # 算子技能 │ ├── agents/ # 算子 Agent 定义 │ └── teams/ # 算子 Teams 配置 ├── ops-lab/ # 算子 Skills/Agents（实验/非正式版） ├── model/ # 模型推理优化 │ ├── skills/ # 推理优化技能 │ ├── agents/ # 推理优化 Agent │ └── teams/ # 推理优化 Teams（含工作流 Skill 和 Hook） └── docs/ # 项目规范文档 └── STANDARDS.md # 开发规范总集

Skills 分类

项目 skills 目录按功能分类，包括：

• 知识库类：提供领域知识和参考资料
• 工程模板类：提供工程脚手架和项目模板
• 调试与测试类：问题诊断和调试
• 测试开发类：测试设计、测试开发和代码检视
• 工具辅助类：辅助工具和实用功能

详细分类见 Skills 开发规范

详细规范

详见 开发规范总集

【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体，本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills