CLI 命令参考

SuperSpec CLI 提供了一套完整的命令来管理规格驱动开发工作流。

命令概览

初始化与设置

命令	说明
init	初始化 SuperSpec 到当前项目
update	刷新 agent 指令和模板

核心工作流

命令	说明
create	创建变更并生成 proposal
archive	归档已完成的变更

质量与验证

命令	说明
lint	检查 artifact 行数是否超限
validate	交叉验证 artifact 一致性

搜索与发现

命令	说明
search	全文搜索变更内容
status	查看所有变更状态

依赖管理

命令	说明
deps list	查看依赖关系
deps add	添加 spec 依赖
deps remove	移除 spec 依赖

上下文恢复

命令	说明
sync	同步 git 变更到 context.md

全局选项

所有命令都支持以下全局选项：

superspec --version    # 显示版本号
superspec --help       # 显示帮助信息
superspec <command> --help    # 显示特定命令的帮助

命令分类

按使用频率

日常使用：

• create - 开始新变更
• status - 查看状态
• sync - 同步上下文
• archive - 归档变更

定期使用：

• lint - 检查大小限制
• validate - 验证一致性
• search - 搜索内容

偶尔使用：

• init - 项目初始化
• update - 更新模板
• deps - 依赖管理

按工作流阶段

开始阶段：

1. init - 初始化项目
2. create - 创建变更

开发阶段： 3. lint - 检查限制 4. validate - 验证一致性 5. sync - 同步上下文 6. deps - 管理依赖

完成阶段： 7. archive - 归档变更

退出码

退出码	含义
0	成功
1	一般错误

配置文件

CLI 命令会读取 superspec.config.json 配置文件。详见配置详解。