SuperAPI AI 工具集

spec-add

通用与其它

查看项目

更新于 10-16 08:06

技能介绍

用途:spec-add 用于逐条添加规范、约定、约束或会话中总结的经验教训,写入项目指南体系,方便后续会话复用。

主要能力:支持项目规范(specs)与个人规范(personal)两个维度;个人规范可选择 global 或 project 作用域;按工作流阶段和类型分类组织内容;提供交互向导模式与直接 CLI 模式;直接模式可自动识别类型与分类;支持 -y/--yes 自动确认,便于脚本使用。类型包括 convention(编码风格偏好)、constraint(不可违反的硬性规则)、learning(会话洞察);类别涵盖 general、exploration、planning、execution 以及 coding_style、naming_patterns、file_structure、documentation、architecture、tech_stack、performance、security、testing、process、other。

使用方式:可运行 $spec-add 进入完整交互向导,或 $spec-add "规则文本" 进入直接模式并自动识别类型;也可显式指定 --type、--category、--dimension、--scope,例如 $spec-add -y "No direct DB access" --type constraint。写入后会自动运行 ccw spec rebuild 重建规范索引;若规范文件不存在,会先执行 ccw spec init 与 ccw spec rebuild。

适用场景:会话中实时记录重要决策、会话结束归档前回顾经验、主动补充团队约定或架构规则。

限制:规则文本在自动模式下为必填;个人维度下若未指定 scope,交互模式会询问,自动模式默认 project;内容按去重逻辑跳过已存在规则。价格、平台、版本等未提供。