关于 specsfy-interviewer
specsfy-interviewer 是一项根据规格当前状态开展访谈并更新内容的技能。它聚焦影响下一步的关键信息缺口,只记录已确认的决定,并将门禁审批和状态转换交给相应技能处理。
主要功能
- 01按规格状态调整访谈重点
- 02聚焦影响下一步的信息缺口
- 03仅用已确认决定更新规格
- 04确认后调整 Effort
- 05移交验证与状态转换
适用场景
- 01澄清早期草案的需求
- 02在规划前解决歧义
- 03讨论执行中发现的变更
- 04检查验收与交付后续事项
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ promovaweb/ specsfy --skill specsfy-interviewer安装后在 Claude Code 中输入/specsfy-interviewer确认已加载。
附带文件agents/openai.yaml
详细介绍
根据当前状态与 spec 对话
必须完成的准备工作
执行此 skill 前,必须先在项目根目录加载 $specsfy-setup。自动交接时,在此步骤前重新加载。复用对话中已确认的根目录;如果 setup 指出有待处理事项,则不要继续。
交互模式
交互模式:perguntas。
在提出任何问题前,阅读并遵循 .specsfy/Spec.md 中的
Contrato de perguntas numeradas。
根据提供的 ID 阅读 spec.md,并确认状态文件夹。文件夹是操作状态;Status 是其可验证的镜像。将 spec 保留为规范来源,仅记录负责人确认过的答复、选择和理由。
引导对话
- 阅读 spec、其 gates、任务、证据和项目上下文。
- 找出对下一步影响最大的实际缺口,并按照中央协议组织一轮提问。
- 每轮提问后重新评估 spec。不要重复已确认的信息,也不要把提问当作例行程序。
- 确认答复后,更新 spec 中相应的章节。如果新信息改变了所需能力,也要调整 Effort。
- 将验证、实现或转交的责任交给相应的 skill。此 skill 不批准 gate、不执行任务,也不移动 spec。
根据文件夹调整重点
| 文件夹 | 对话重点 |
|---|---|
draft | 问题、参与者、行为、规则、故障和验收 |
defined | 影响计划、数据、安全或测试的歧义 |
planned | 依赖关系、任务顺序、TDD 和 BDD 策略 |
in-progress | 后期变更、执行中的发现以及对范围的影响 |
review | 已观察到的验收情况、文档、交付待办事项和反馈 |
completed | 不要通过访谈修改交付内容;应通过正确的流程启动或重新打开变更 |
inbox 不接受提问。backlog 仍由
$specsfy-02-backlog 负责;必要时,该 skill 会调用此发现协议。
更新 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。
存在 ClickUpfy 时进行集成
如果项目包含 clickupfy-* skill,且 spec 有 ClickUp Task,则在状态转换或调整 Effort 后,加载相应的 ClickUpfy skill。使用项目配置的映射;如果没有配置,则使用 draft/defined/planned 对应 To Do,in-progress 对应 In Progress,review 对应 In Review,completed 对应 Complete。
本地状态始终是规范状态。如果远程更新未能完成,则在 spec 中记录待处理事项,不要声称同步已完成。
限制
- 不得捏造答复、Effort、任务关联或远程状态。
- 不得通过修改处于
completed状态的 spec 来启动新变更。 - 不得使用系统命令移动文件夹;只有在通过 gates 后,才可由负责的 skill 使用
specsfy transition。 - 未配置集成的 spec 不得强制要求使用 ClickUp。