mcpField
S
specsfy-interviewer

specsfy-interviewer

github.com/promovaweb开发87445 次安装1 周前更新
代码仓库

关于 specsfy-interviewer

specsfy-interviewer 是一项根据规格当前状态开展访谈并更新内容的技能。它聚焦影响下一步的关键信息缺口,只记录已确认的决定,并将门禁审批和状态转换交给相应技能处理。

主要功能

  1. 01按规格状态调整访谈重点
  2. 02聚焦影响下一步的信息缺口
  3. 03仅用已确认决定更新规格
  4. 04确认后调整 Effort
  5. 05移交验证与状态转换

适用场景

  1. 01澄清早期草案的需求
  2. 02在规划前解决歧义
  3. 03讨论执行中发现的变更
  4. 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 保留为规范来源,仅记录负责人确认过的答复、选择和理由。

引导对话

  1. 阅读 spec、其 gates、任务、证据和项目上下文。
  2. 找出对下一步影响最大的实际缺口,并按照中央协议组织一轮提问。
  3. 每轮提问后重新评估 spec。不要重复已确认的信息,也不要把提问当作例行程序。
  4. 确认答复后,更新 spec 中相应的章节。如果新信息改变了所需能力,也要调整 Effort。
  5. 将验证、实现或转交的责任交给相应的 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。

评论

支持 Markdown