Task 调用契约【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills各步子 Agent 的调用参数、输入/输出、验收标准。编号与 SKILL.md 统一流程表 一一对应。调用原则PM 调度子 Agent 时只定义「输入 / 输出 / 验收标准」严禁干涉实现细节最小信息、最小权限。交付件模板引用workflow-doc-templates逻辑名领域知识引用repo-*逻辑名。通用约定报告格式各步交付的报告/文档统一从workflow-doc-templates取对应模板作为格式基准。中间产物子 Agent 将交付件直接写入下发时约定的.cannbot路径并回传结构化摘要状态 / 交付件路径 / 遗留问题。.cannbot所有角色均可写。写权限各角色写权限由 hook 按角色限定执行角色遵守「修改不越权」——发现上游设计问题回退给上游不自行改设计决策。CP 验收各 CP 点由 QA 加载对应workflow-cp*Skill 完成验收验收标准可被子仓 override不通过返回结构化修改意见按流程表「备注」列回退。需用户确认的 CPQA 生成问卷 json 交 PM 发送给用户。任务恢复映射中断时按.cannbot/state.json的current_stage恢复到对应子 Agent详见 state-schema.md。恢复时读取已产出交付件继续不重跑已通过阶段。中断阶段恢复角色恢复说明0 / CP0developer / PM读环境信息文档继续1.1 / 1.2PM / architect读需求文档 / Spec 继续2.1 / 2.2architect读方案文档继续3.1 / 3.2 / 3.3developer-code / developer-test读代码与测试继续CP3 / CP4 / CP5QA读对应报告继续回退则从 3.1 重走6.xdeveloper-doc / developer读 PR 状态继续7.xdeveloper-doc读交付物继续阶段 0开发准备0 开发准备角色developer输入无可复用已有环境信息文档输出环境信息文档模板workflow-doc-templates的0-环境信息动作检查 NPU 设备、CANN 环境、编译环境将环境信息文档写入下发时约定的.cannbot路径验收标准环境信息文档完整各检查项有明确结论备注支持独立触发交付件可复用CP0 环境确认角色QA加载workflow-cp0输入环境信息文档输出用户确认问卷 json通过指标用户确认环境校验结果满足开发要求动作QA 加载workflow-cp0生成环境确认问卷 jsonPM 发送给用户不通过由用户决定修复环境或停止开发阶段 1需求分析1.1 需求分析角色PM输入对话上下文、仓库设计约束输出需求文档模板1.1-需求分析动作整理数学定义、算子原型、目标芯片、精度/性能要求、其他要求核对模板确认项用户未提及的通过问卷补齐验收标准确认项无遗漏用户原始需求逐条记录CP1 需求确认角色QA加载workflow-cp1输入需求文档通过指标需求完整、明确、可执行确认项齐全动作QA 加载workflow-cp1核对需求文档需用户确认时生成问卷 json 交 PM 发送不通过返回结构化修改意见回退 1.11.2 Spec 生成角色architect输入需求文档输出spec.yaml机器可校验 Spec规范由共享 skillops-spec-gen定义见workflow-doc-templates的1.2-Spec指引动作将需求形式化为 L0 数学契约作为方案设计与测试设计的共同真值源验收标准validate_spec.py9-stage 全 PASS字段与需求文档一致可追溯CP1 Spec 确认角色QA加载workflow-cp1-prime输入spec.yaml通过指标9-stage 校验通过Spec 准确完整地形式化了需求动作QA 加载workflow-cp1-prime核对 Spec需用户确认时生成问卷 json 交 PM 发送不通过返回结构化修改意见回退 1.2阶段 2方案设计方案线 / 测试线并行2.1 黑盒测试设计角色architect输入spec.yaml输出测试方案文档模板2.1-测试方案设计动作设计 golden 实现方案、L0/L1/L2 分级用例测试配置以 spec 为真值源验收标准golden 方案可行分级用例覆盖充分正常/边界/异常/特殊值CP2.1 测试检查角色QA加载workflow-cp2-1输入测试方案文档通过指标golden 方案合理、用例覆盖完整、与 spec 一致动作QA 加载workflow-cp2-1完成黑盒测试评审不通过返回结构化修改意见回退 2.12.2 开发方案设计角色architect输入spec.yaml输出开发方案文档模板2.2-开发方案设计动作设计代码架构MemBase/RegBase/SIMT、Buffer 规划、Tiling、多核切分、Ascend C 接口验证验收标准架构选型合理、Tiling/切分策略可行、关键 API 已验证CP2.2 方案检查角色QA加载workflow-cp2-2输入开发方案文档通过指标设计可行、与 spec 一致、无明显性能/正确性隐患动作QA 加载workflow-cp2-2完成开发方案评审不通过返回结构化修改意见回退 2.2CP2 方案确认角色QA加载workflow-cp2-prime输入开发方案 测试方案通过指标CP2.1、CP2.2 均通过两方案相互吻合无冲突动作QA 加载workflow-cp2-prime做两方案一致性合并确认不通过返回结构化修改意见回退对应步骤阶段 3代码开发开发线 / 测试线并行3.1 算子开发角色developer-code输入开发方案文档、修改要求被打回时输出算子代码动作按开发方案实现算子代码编译验证通过引用repo-op-templates模板起点、repo-coding-rules编码规范、repo-build-guide编译验证验收标准编译通过按方案实现被打回时按修改要求调整越权约束性能/正确性瓶颈定位后回退给设计角色不自行改 Tiling/切分/接口3.2 测试工程开发角色developer-test输入测试方案文档输出golden 代码 用例表 性能采集框架动作实现 golden、功能用例表、搭建性能采集框架引用repo-test-develop测试框架用法验收标准golden 可产出期望输出用例表按分级覆盖性能采集框架可用3.3 白盒测试补全角色developer-test输入算子代码、测试代码输出白盒测试用例动作基于算子代码补充白盒用例覆盖黑盒未涉及的分支验收标准分支覆盖达标具体阈值见配置CP3 功能验收角色QA加载workflow-cp3输入算子代码 测试代码输出功能验收报告模板CP3-功能验收报告通过指标全量功能测试通过率 100%精度比对在容差内引用ops-precision-standard动作QA 加载workflow-cp3执行全量功能测试与精度比对产出报告不通过返回结构化修改意见回退 3.1阶段 4性能验收4.1 性能采集执行角色developer-test输入算子代码CP3 通过后的最终代码输出性能数据动作用 3.2 搭建的性能采集框架跑出性能数据各 shape/dtype 的耗时、带宽、利用率验收标准性能数据完整覆盖需求关注的 shape/dtypeCP4 性能验收角色QA加载workflow-cp4输入算子代码 性能数据4.1 产出输出性能验收报告模板CP4-性能验收报告通过指标性能达到目标值需求文档给定无明确目标时以瓶颈分析结论判定动作QA 加载workflow-cp4评估性能是否达标产出报告不通过返回结构化修改意见回退 3.1重走 3.3 → CP3 → 4.1 → CP4阶段 5代码检视CP5 代码检视角色QA加载workflow-cp5输入全部变更文件输出检视结论模板CP5-代码检视报告通过指标多维度检视全过——代码规范引用repo-coding-rules、设计一致性、潜在风险、冗余清理动作QA 加载workflow-cp5完成多维度代码检视产出检视结论不通过返回结构化修改意见回退 3.1重走至 CP5阶段 6上库准备6.1 文档补全角色developer-doc输入算子代码 设计文档输出算子文档模板6.1-算子文档验收标准接口、参数、约束、示例齐全6.2 提交 PR角色developer-doc输入全部代码 文档输出PR验收标准PR 描述完整变更范围清晰6.3 CI 流水线角色CI外部流水线非调度子 Agent输入PR输出CI 报告编译 UT ST6.4 codecheck 修复角色developer输入CI 报告输出修复后代码验收标准codecheck 问题清零6.5 检视意见修复角色developer输入PR 检视意见输出修复后代码验收标准检视意见逐条闭环CP6 CI 通过确认角色QA加载workflow-cp6输入CI 报告 PR 状态通过指标CI编译 UT ST最终通过、检视意见已闭环动作QA 加载workflow-cp6确认 CI 通过与检视意见闭环不通过回退 6.4 / 6.5 修复后重触发 CI受过程有界约束阶段 7开发总结7.1 开发报告角色developer-doc起草→ PM落盘.cannbot输入全部交付物输出开发报告模板7.1-开发报告验收标准开发过程、交付物清单完整7.2 经验总结角色developer-doc起草→ PM落盘.cannbot输入开发过程记录输出经验总结文档模板7.2-经验总结验收标准沉淀有效经验与踩坑记录含对工作流/领域知识的改进建议【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考