SuperAPI AI 工具集

canon

编程与开发

查看项目

更新于 10-15 20:34

技能介绍

用途:Canon 用于在做出架构或工作流选择之前,先加载并理解项目治理内容,避免在陌生子系统中凭假设行事。它强调 CLI 是事实来源,项目约定记录在 CLAUDE.md、AGENTS.md 等文件中。

主要能力:列出并阅读与任务相关的治理资料,包括 spec(产品意图/技术架构)、adr(架构决策记录)、policy(政策)、standard(实践标准),以及本次变更设计意图的 design.md。可用 doctrine <kind> show <id> 查看具体条目,或用 doctrine search "<keywords>" -k governance 直接检索治理相关内容。政策与标准不在默认 kind 范围内,需使用扩展范围的标志。

使用方式:先识别与任务相关的权威资料,再按需完整阅读,而非每次全部读取。实现层面的细节(陷阱、模式、与文件或命令相关的不变量)应通过 /retrieve-memory 获取,而不是重新发现。实体应按层级读取,通过 show 而非直接读取原始文件;存储层级包括 authored、runtime、derived,只读一层就断定“为空”是错误的。

限制与约束:需避免假设、猜测(如编造 id、命令形式或文件位置)、重复实现、违反设计或 ADR、以及破坏边界的耦合。若治理内容缺失、矛盾或对重要选择含糊不清,应停止并 /consult,而不是围绕猜测进行规范化。具体命令细节与范围标志可参考 lib:reference/using-doctrine.md。