# CLI Contract 审查清单

<!-- 本清单是插件通用基线，项目本地审查规则可覆盖 -->

## 结构完整性

- [ ] `id` 字段存在且符合项目 ID 模式（如 `CLI-{nnn}` 或 `{tool}-CLI-{version}`）
- [ ] `title` 清晰描述 CLI 工具
- [ ] `version` 字段存在且符合语义化版本
- [ ] 命令结构层级清晰

## 命令质量

- [ ] 每个命令有清晰描述
- [ ] 选项和参数类型明确
- [ ] 必填/可选标识正确
- [ ] 默认值已说明

## 用户体验

- [ ] 帮助文本准确
- [ ] 错误信息有指导性
- [ ] 退出码语义明确
- [ ] 示例覆盖常见场景

## 向后兼容

- [ ] 破坏性变更已记录
- [ ] 废弃选项有迁移路径
- [ ] 版本升级指南存在

## 追溯性

- [ ] 关联功能特性存在
- [ ] 命令可追溯到用户需求
- [ ] 版本变更可追溯

## 实现一致性

- [ ] 与实现代码一致
- [ ] 文档与实际行为匹配
- [ ] 测试覆盖所有命令
- [ ] 自动补全配置正确（如适用）