SuperAPI AI 工具集

ddd-book

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:ddd-book 用于在项目中初始化并维护 DDD 的“Book”。核心原则是 Book 是所有工程知识的唯一索引,未被索引的内容即不受治理。

主要能力:初始化时创建 .ddd/ 目录结构与 book.yaml 清单(schema_version: 0.1.0),检测并记录项目技术栈(扫描清单文件、锁文件、配置文件,写入 .ddd/project-context.yaml,禁止凭记忆猜测),把需求、ADR、CONTEXT.md 等既有产物索引为 Book 引用并标注独立性等级,生成 knowledge-map.yaml,确定合规档位(Lite 或 Assurance)。同步时扫描新增或更新的 ADR、需求与文档,技术栈变化时重扫并更新 project-context.yaml,标记缺少证据锁条目的依赖,更新引用与 trace-matrix.yaml。校验时检查引用是否存在可访问、证据锁内容摘要是否有效、被撤销条目是否仍被引用、取代链是否一致、project-context.yaml 是否最新、受治理代码的依赖是否都有证据锁条目。发布时计算清单摘要(sha256)、按 semver 打标签并在发布前校验所有引用产物。护照管理为承担职责的设计单元创建和更新对象护照,存在领域模型时应通过 domain_sources 引用。

管理的产物:.ddd/book.yaml(清单)、.ddd/project-context.yaml(项目上下文)、.ddd/knowledge-map.yaml(知识地图)、.ddd/evidence.lock(证据锁)、.ddd/claims.yaml(断言账本)、.ddd/trace-matrix.yaml(追踪矩阵)、.ddd/passports/(护照)、.ddd/decisions/(决策)、.ddd/models/(模型)。

使用方式:在初始化新项目、增改 Book 引用、发布版本、管理护照、同步既有产物、校验完整性或技术栈变化时调用。管理具体变更证据用 ddd-scope,验证变更一致性用 ddd-verify,审计文档债用 ddd-audit。

限制:资料未提供安装命令、价格与平台信息。每次变更后都应校验,避免引用失效、证据锁缺失与约束过期;project-context.yaml 过期会导致证据获取版本错误与漂移误报。