Skip to content

using-spec-first

substantial work 前做 workflow 入口治理,决定是否进入公开 spec-first workflow。

基本信息

字段内容
Skillusing-spec-first
类型standalone-skill
研发链路位置Codebase
入口standalone_skill
Sourceskills/using-spec-first/SKILL.md

描述

Use before substantial work in a spec-first project, and when users ask what spec-first workflow or command to run next. Decide whether to route into a public spec-first workflow before editing files, running state-changing commands, debugging, reviewing, planning, setup, update, or architecture/prompt/workflow decisions.

何时使用

  • 修改文件、调试、评审、规划、setup、update 或架构决策前。
  • 用户询问该用哪个 spec-first 入口。

工作步骤

  • 读取 host、项目说明、运行时配置和本地工具状态。
  • 判断当前事实是否足够支撑下游 workflow。
  • 写出 setup、standards、runtime 或版本状态等可检查证据。
  • 把 ready、blocked 或 degraded 结论交给 Graph、Spec、Plan 或 Code 阶段。

输出

  • 项目 readiness、runtime 或 standards 事实。
  • 可复用的下一步入口建议。
  • 当环境不可用时,输出明确的 blocked / degraded 修复项。

Agent 调度

  • 默认优先使用确定性脚本、本地文件和 provider 状态。
  • 只有在需要解释代码库惯例、历史背景或规范漂移时,才引入研究或审查类 agents。

边界

  • 它不是 command-backed workflow。
  • 只做入口判断;进入 workflow 后由该 workflow 接管。