SuperAPI AI 工具集

c3-provision

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:在代码存在之前记录架构设计。该技能创建 ADR(架构决策记录)与组件文档,组件状态为 provisioned,仅做设计规划,不执行实现。

主要能力:按阶段推进流程——意图澄清、现状分析、范围影响评估、创建 ADR(status: proposed)、用户接受 ADR、创建 provisioned 文档、将 ADR 状态更新为 provisioned。新组件写入 .c3/provisioned/c3-X/c3-xxx.md;更新已有组件时使用 supersedes 指向原文档。ADR 生成于 .c3/adr/adr-YYYYMMDD-{slug}.md。

使用方式:用户以“provision X”“design X”“plan X”触发。开始前需用 Glob 查找并阅读 references 下的 skill-harness.md、layer-navigation.md、adr-template.md、component-lifecycle.md。流程中通过 AskUserQuestion 确认意图、范围与 ADR 接受。创建新组件目录示例:mkdir -p .c3/provisioned/c3-X-container。

适用场景:需要先记录设计、稍后实现时;新增组件或修改已有组件的设计文档化。

限制:不包含 c3-dev 执行阶段,不产生代码变更,approved-files 保持为空;provisioned 组件文档不包含 Code References 部分。实现需另建 ADR 并设置 implements 指向原 ADR。与 c3-orchestrator 的关系是仅使用其分析阶段,在 ADR 接受后停止。其他细节资料未提供。