关于 spec-first
spec-first 是用于非简单实现任务的规划与交付技能,供执行者和独立审查者依据同一 issue 与计划协作。它通过准备、就绪度检查、实施和交付验证来管理决策与证据。
主要功能
- 01在 issue 中集中需求、决策与步骤
- 02检查执行就绪度及计划新鲜度
- 03按授权范围委派实施
- 04要求独立审查与交付证据
适用场景
- 01为非简单功能准备可执行计划
- 02检查计划是否足以进入实施
- 03按已批准计划实施并验证交付
- 04追踪审查或 CI 缺失造成的阻塞
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ shipshitdev/ skills --skill spec-first安装后在 Claude Code 中输入/spec-first确认已加载。
附带文件plugin.json
详细介绍
先编写规范,再开发
对于非简单实现,先遵循共享的准备流程。将需求、决策和步骤保留在同一个议题中,以便执行者和独立审查者检查同一份事实来源。
流程约定
输入:
- 用户请求、代码仓库、现有议题/计划,以及已获授权的交付范围。
输出:
- 可直接执行的议题,或具体的规划阻碍事项。
- 获准实施时,提供实施证据和交付门禁状态。
创建/修改:
- 通过受委托的引擎,在调用方授权范围内创建/修改所请求的准备材料、实现内容和交付产物。
外部副作用:
- 仅限已获授权的跟踪器/代码仓库操作;遵守所有访问权限和主机限制。
所需确认:
- 现有的实施授权涵盖同一范围内的准备和执行。仅在缺少重要意图或需要扩大授权时才询问。 仅请求准备工作的流程在准备完成后即停止。代码仓库合并/部署权限以及必需的审查/CI 门禁仍然适用。
委托给:
feature-intake,负责需求梳理和已确定的实施规划。prd-quality-gate,负责阻止执行准备不足的任务并验证信息是否为最新。executing-plans,负责按要求实施并提供交付证据。
工作流程
- 如已提供实时议题和当前计划,先阅读。如果材料缺失或需要准备,则运行
feature-intake技能。该协调器使用规范的需求和计划模板;不要另建独立的规范、待办事项和决策文件,也不要强迫用户在三种备选方案中做选择。 - 针对当前代码和需求,以
execution-readiness模式运行prd-quality-gate技能。规划者负责弥补缺口并修正过时假设;不得授予执行者自行决定缺失行为或架构的权限。 - 如果已获准实施且状态为 READY,则运行
executing-plans技能,并提供准确的议题/当前计划、范围、主机限制和必需的交付门禁。遵循运行环境选定的执行者;不要在此处选择模型或工作量。 - 要求提供实施检查、完整的验收证据、由运行环境策略选定的另一实验室进行独立审查,以及最终 PR 提交所需的 CI。计划审查或自我审查不能替代实施审查。审查资源不足时,必须明确标示,并阻止任务完成。
- 将未解决的决策交回规划者,将代码缺陷交由指定流程修复,并将无法访问或执行检查的情况明确标记为受阻状态。代码变更后,针对实际的最终修订版本重新进行受影响的检查/审查。
- 如实报告交付状态。只有完整满足全部验收约定和项目交付门禁,功能才算完成。子任务/后端 PR 合并以及部分 CI 检查通过,都不能作为关闭未完成的功能或 Epic 的依据。
范围适度
对于范围明确的工作,使用精简材料;拼写错误或机械性编辑无需完整 PRD。保持相同的决策和验证边界。完整功能应在其议题中包含所有必要的 API、UI、连接逻辑、迁移、测试、文档和运维交接;如需拆分,应遵循共享的独立成果规则。
评论
支持 Markdown