用途:当一份 spec 处于 draft、defined、planned、in-progress 或 review 状态,需要通过对话解决缺口、重新校准 Effort 或记录回答时使用。执行前必须在项目根目录加载 $specsfy-setup;自动交接时需再次加载,并复用已确认的根目录,若 setup 提示待处理项则不要继续。
主要能力:以“提问”模式进行交互,提问前须阅读并应用 .specsfy/Spec.md 中的编号提问契约。按给定 ID 读取 spec.md 并确认状态文件夹;状态文件夹是操作状态,Status 是其可验证镜像。保留 spec 作为规范来源,只记录负责人确认的回答、选择和理由。
使用方式:读取 spec、其 gates、任务、证据和项目上下文;找出最影响下一步的真实缺口,按中央契约组织一轮提问;每轮后重新评估 spec,不重复已确认信息,不把提问当仪式。确认回答后更新 spec 相应章节;若新信息改变所需能力,同时调整 Effort。Effort 取 1–10 整数并附简短理由:1–2 原子且模式已知;3–4 局部改动与直接测试;5–6 多文件或已知集成;7–8 跨领域、迁移或外部集成;9–10 架构、高不确定性或频繁人工评审。确认后执行:specsfy effort <id-da-spec> <1-10> --reason "<o que mudou a estimativa>"。该命令更新 spec.md 中的 Effort、日期、理由和历史。不要将估算绑定到模型名称,而用区间选择 light、standard、high 或 maximum 执行配置。
按状态聚焦:draft 关注问题、参与者、行为、规则、失败与验收;defined 关注影响计划、数据、安全或测试的歧义;planned 关注依赖、任务顺序、TDD 与 BDD 策略;in-progress 关注后期变更、执行发现与范围影响;review 关注观察到的验收、文档、交付待办与反馈;completed 不应通过访谈修改交付,应走正确流程启动或重开变更。inbox 不接收提问;backlog 仍由 $specsfy-02-backlog 负责,必要时调用本发现协议。
ClickUpfy 集成:若项目含 clickupfy-* 技能且 spec 有 ClickUp Task,在状态转换或 Effort 调整后加载相应 ClickUpfy 技能。使用项目配置的映射;缺失时 draft/defined/planned 对应 To Do,in-progress 对应 In Progress,review 对应 In Review,completed 对应 Complete。本地状态保持权威;若远程更新未发生,在 spec 中记录待办,不得声称同步完成。
限制:不得编造回答、Effort、任务关联或远程状态;不得通过修改 completed 的 spec 来启动新变更;不得用系统命令移动文件夹,只能在负责技能通过其 gates 后使用 specsfy transition;没有配置集成的 spec 不要求 ClickUp。