工作流检视条款【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills由 design-constraints.md 派生。每次修改工作流后逐条自查条款不通过则回退修改。 原件是设计意图本清单是可执行的检查动作。一、结构约束SOLID编号检查项派生自S1每个 skill 是否只负责单一功能域是否把不相关的知识如把架构最佳实践塞进编码规范 skill混了进来单一职责 SS2扩展某步骤时是否通过 override virtual skillrepo-*/workflow-cp*实现而没有改动基类编排流程开闭 OS3子仓 override 后逻辑名、输入输出格式、调用方式是否与基类完全一致上层是否无需感知替换里氏替换 LS4是否只 override 了需要的组件没有强迫子仓为改一个组件而实现全部 virtual 组件接口隔离 IS5编排是否只依赖抽象逻辑名如repo-coding-rules而不依赖具体实现路径 / 章节结构依赖倒置 DS6改基类时暴露的契约逻辑名 / 输入输出格式 / 调用约定是否只新增、未破坏破坏性变更是否提供了迁移路径并通知已接入仓基类演进兼容二、层级感知编号检查项派生自H1下级模块是否不感知上级子 Agent 不知自己在工作流哪一步skill 不提及被哪个 agent 调用层级间单向感知H2同级模块是否互不了解对方内部逻辑层级内黑盒感知三、调度约束编号检查项派生自D1任务的执行方与验收方是否为不同 Agent 实例职责分离D2调度子 Agent 时是否只注入当前任务所需的最小信息无无关全局上下文最小信息D3子 Agent 是否只被授予完成任务所需的最小写权限如开发角色不给 test 目录写权限最小权限D4所有可能循环/重试的环节是否都声明了最大次数超限暂停并报告而非无限重试过程有界D5每个子环节是否有明确交付件与可判定的通过指标评分/容差/用例全通过等确定性交付D6每个阶段完成后是否把状态持久化到外部如.cannbot/state.json不依赖会话记忆状态可观测D7暂停/失败是否落盘到可恢复状态点已完成阶段阻塞点交付件恢复时不重跑已通过阶段可恢复性D8执行角色是否严格遵循上游设计、发现问题回退给上游而非自行改动上游决策架构/Tiling/接口修改不越权四、风格约束编号检查项派生自F1SKILL.md 是否只做意图识别与路由分发不内联知识细节SKILL.md 只做路由F2能用 hook / 脚本 / 权限声明实现的约束是否没有退化成 prompt 里的自然语言机制优于自然语言F3涉及仓库领域知识时是否通过路径引导 agent 读原文而非全文硬编码进 skill引用而非硬编码F4对开发者同样可见的知识测试框架用法、编码规范是否优先放仓内 docskill 只做引导开发者知识外置F5举例是否只用仓内已有知识或通用概念没有引入需额外背景才懂的外部概念举例不引入外部概念五、链接一致性本工作流特有编号检查项L1新增/删除 skill 后是否重新运行了 init 使软链接生效L2子仓 override 的逻辑名skill 目录名 / SKILL.md 的name:是否与基类一致能被正确匹配L3是否只改了源文件没有直接改运行时目录.opencode/里的软链接目标L4新增 skill 若需被某 agent 使用是否已加入对应 agent或 AGENTS.md的skills:frontmatter否则 init 收集不到L5改动了流程阶段 / CP / 回退关系后插件根README.md的「开发流程概览」表是否仍与ops-direct-invoke-workflow/SKILL.md的统一流程表一致阶段、CP 编号、回退指向【免费下载链接】cannbot-skillsCANNBot 是面向 CANN 开发的用于提升开发效率的系列智能体本仓库为其提供可复用的 Skills 模块。项目地址: https://gitcode.com/cann/cannbot-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考