mcpField
C
canon

canon

github.com/davidleeAgent 工作流2145 次安装3 天前更新
代码仓库

关于 canon

canon 是指导 Agent 在修改项目前先检查项目治理、设计意图和实现依据的技能。它强调通过 doctrine CLI 按需读取权威文档,并在规则缺失或矛盾时暂停确认。

主要功能

  1. 01检查项目指令与治理文档
  2. 02使用 doctrine 命令查找和读取规范
  3. 03按任务相关性选择权威资料
  4. 04治理信息不明确时停止并咨询

适用场景

  1. 01开始代码修改前确认项目规范
  2. 02根据设计文档和 ADR 判断实现方案
  3. 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