用途:通过结构化对话与迭代校验,创建、更新或重新解读五级 RootSpec 产品规格。适用于用户希望定义、扩展或修订产品规格时。
主要能力:五级规格 L1 哲学、L2 真值、L3 交互、L4 系统、L5 实现;支持全量新建、按功能增改、针对某层级编辑三种流程;内置校验(层级、数值、重复 ID、支柱质量、权衡、覆盖)及原代码对照校准。
使用方式:从项目根目录运行扫描脚本 bash "$(dirname "$0")/../rs-shared/scripts/scan-spec.sh" . 与 scan-project.sh;无 .rootspec.json 时需先运行 /rs-init。交互模式逐层提问并逐层确认,非交互模式(如 CI 中 claude -p)直接依据初始上下文起草。写出后运行 validate-spec.sh 校验,通过后执行 write-spec-status.sh rootspec true 并可选 init-conventions.sh 提取约定;结束记录 write-stats.sh。
适用场景:新建产品规格、向现有规格添加功能、修改特定层级,以及基于现有代码库推导规格。
限制:仅可写入 rootspec/ 目录,不应写应用代码、测试文件、.rootspec.json 或 tests-status.json;校验修复最多 3 轮;层级引用只能向上;路径不可解析时需在技能目录中查找脚本;部分视觉/技术约定需人工补全。具体收费与价格暂未提供。