企业官网建设流程全解析

cuda2ascend

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

社区版直调算子开发工作流。用户描述算子需求，Agent 团队按统一流程从需求分析走到代码上库，全程可追溯、可恢复、可定制。

借鉴了面向对象的设计思想，本仓内维护一套通用工作流基类，各生态算子仓作为子类，可以拉取使用本工作流，覆写与自身耦合的领域知识，按照仓内开发流程定制本工作流，达到一套核心流程服务所有算子仓，消除重复建设的目的。

设计思想

借鉴面向对象思想重构直调算子工作流：CANNBot 仓维护一套通用工作流作为基类，各算子仓的工作流作为子类，继承基类编排流程，仅覆写与自身耦合的领域知识和验收实现。

• 封装：对算子仓隐藏编排的复杂实现，工作流将编排逻辑封装为知识接口。算子仓只关心"我提供什么知识"，不关心"工作流怎么用"。
• 继承：CANNBot 提供基类，算子仓继承基类，只覆写自己需要的部分。
• 多态：工作流核心始终通过逻辑名引用可覆写 Skill（领域知识、验收标准），实际实现在 init 时由 symlink 绑定确定。

知识分层

知识分布按抽象层级从高到低分层，越靠上越通用稳定、越靠下越具体易变：

其中 Agent 与 Skill 相邻两层职责最易混淆，判定原则：会变、需被子仓 override 的领域知识归 Skill；跨仓通用、用于定义角色身份与行为边界的内容归 Agent。

参与角色

开发流程概览

完整流程从需求分析到上库分 8 个阶段，方案线与测试线在设计/开发阶段并行，CP3/CP4/CP5 构成验收状态机：

设计约束

为保证实现一致性、在方案出现分歧时提供统一指导，本工作流约定了一组设计约束。理解这些约束能帮助参与开发的开发者把握最初的设计思路——为什么定制要靠 override 而非改编排、为什么执行方与验收方必须分离、为什么中间状态要落盘。

约束由 skill 看护：这组约束不是一次性文档，而是由ops-direct-invoke-workflow-maintainskill 持续看护的维护红线。任何对工作流文件的新增/修改/删除都须先触发该 skill，改完后按其派生的可执行检视条款逐条自查——约束不通过则回退修改。开发者若要演进工作流，务必先阅读该 skill。

结构约束（SOLID）

层级感知

层级感知方向：主 Agent → 工作流 → 子 Agent → Skill → 仓内文档。

• 层级间单向感知：下级模块不感知上级（子 Agent 不知自己在流程哪一步，Skill 不提及被谁调用）。
• 层级内黑盒感知：同级模块之间互不了解对方内部逻辑。

调度约束

风格约束

• SKILL.md 只做路由：入口文件只做意图识别与路由分发，知识细节放 references。
• 机制优于自然语言：能用 hook / 脚本 / 权限声明约束的行为，不写成 prompt 自然语言。
• 引用而非硬编码：涉及仓库领域知识时引导 Agent 读原文，而非全文硬编码进 Skill。
• 开发者知识外置：对开发者同样可见的知识优先放仓内 doc，Skill 只做引导。
• 举例不引入外部概念：举例只用仓内已有知识或通用概念，不引入需额外背景才懂的概念。

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