关于 canon
canon 是指导 Agent 在修改项目前先检查项目治理、设计意图和实现依据的技能。它强调通过 doctrine CLI 按需读取权威文档,并在规则缺失或矛盾时暂停确认。
主要功能
- 01检查项目指令与治理文档
- 02使用 doctrine 命令查找和读取规范
- 03按任务相关性选择权威资料
- 04治理信息不明确时停止并咨询
适用场景
- 01开始代码修改前确认项目规范
- 02根据设计文档和 ADR 判断实现方案
- 03查找文件相关的实现约束与既有模式
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davidlee/ doctrine --skill canon安装后在 Claude Code 中输入/canon确认已加载。
详细介绍
Canon
行动之前先了解项目治理,避免传播异端。
真理条文
找出与你的任务相关的权威依据,然后阅读对任务有意义的内容——不必每次都读完所有内容。CLI 是事实来源——参见 [[mem.fact.doctrine.cli-source-of-truth]]。
CLAUDE.md、AGENTS.md— 长期指令和约定。项目约定记录在 [[mem.pattern.doctrine.conventions]]。- 项目治理——逐项列出;对可能相关的内容,使用
doctrine <kind> show <id>阅读全文:doctrine spec list— 描述产品意图 / 技术架构的规范doctrine adr list— 架构决策记录doctrine policy list— 策略doctrine standard list— 实践标准- 或直接查找与你的任务相关的内容:
doctrine search "<keywords>" -k governance。策略和标准不属于默认类别范围,因此仅执行基础搜索会恰好漏掉你要找的规则——lib:reference/using-doctrine.md说明了范围和扩展范围的标志。
- 治理范围对应的
design.md— 本次变更设计意图的准则。
对于实现方面的事实(与文件或命令相关的注意事项、模式、不变量),请使用 /retrieve-memory,不要重新摸索。
按层级读取实体——通过 show,绝不要直接读取原始文件。 存储规则和通过 show 读取的规范,已收录在启动摘要中,并详述于 lib:reference/using-doctrine.md。存储模型和存储规则记录在 [[mem.concept.doctrine.storage-model]];存储层级:编写、运行时、派生——参见 [[mem.fact.doctrine.storage-tiers]]。只读取其中一个层级便断定“为空”,就是作伪证。
致命之罪
务必警惕,并拒绝犯下以下过错:
- 臆断 — 依据猜测行事,而非依据已确认的事实。
- 猜测臆造 — 虚构 ID、命令格式或文件位置。
- 重复造轮子 — 已有接口可用,却另行实现一套。
- 违背架构 — 违反设计或 ADR。
- 异端式耦合 — 新增违反边界的导入或依赖。
如果治理内容缺失、相互矛盾,或对重要选择存在歧义,请停下并执行 /consult,不要基于猜测擅自定论。
评论
支持 Markdown