SuperAPI AI 工具集

constitution

办公与效率

查看项目

更新于 10-15 21:52

技能介绍

用途:管理项目的架构 DNA,由两个共享文档承载:docs/specs/architecture.md(技术栈、基础设施、架构规则、安全约束、AI 护栏)与 docs/specs/ontology.md(领域术语表/统一语言,含术语、定义、限界上下文)。两文件位于 docs/specs/,被所有规格共享,由 brainstorm(Phase 6.8.6)与 spec-to-tasks(Phase 1.5)创建或补充。

主要能力:create 询问创建哪些文件(两者、仅 architecture.md、仅 ontology.md),检查文件是否存在并询问覆盖或跳过,通过 AskUserQuestion 收集信息后按模板写入;update 解析 --file=architecture|ontology 与 --section=<name>,精准修改并更新 Last Updated 日期;check 读取两个宪法文件与目标文件,按架构规则、安全约束和本体术语校验,输出 Constitution Check Report;show 读取并格式化展示两个文件。写入或覆盖前始终与用户确认。

用法示例:/developer-kit-specs:constitution create;/developer-kit-specs:constitution check --target=docs/specs/001/2024-01-15--user-auth.md;/developer-kit-specs:constitution update --file=architecture --section=security;/developer-kit-specs:constitution show。

适用场景:新项目在首次 brainstorm 前定义技术栈与领域语言;技术栈或安全规则变更;校验规格、任务或文件是否符合架构与本体;审阅当前架构与本体。

限制:不修改源代码,只创建/更新宪法文件;每个项目仅一份 architecture.md 与 ontology.md;CRITICAL 违规必须解决,WARNING 为建议;每次变更需更新 Last Updated 日期;重大架构决策应使用 ADR;文件超过 30 天可能已漂移。报告格式为安全、CWE 合规、架构、库验证、本体依次排列。