using-spec-first ​

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

ASCII 链路图 ​

text
Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
    |
    v
    using-spec-first
    entry: standalone skill
    type: standalone-skill

基本信息 ​

字段内容
Skillusing-spec-first
类型standalone-skill
研发链路位置Codebase
当前入口standalone skill
兼容别名不适用
Sourceskills/using-spec-first/SKILL.md
Governancesrc/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述 ​

Standalone entry governor for spec-first. Use before substantial work in a spec-first repo or when the user asks what to run next; choose one public spec-* workflow, standalone skill, terminal command, or Direct Lane. Do not use to reroute active public workflows or bounded workers, or for lightweight facts, current-context explanations, narrow lookups, user-supplied single-document cleanup, or clearly scoped low-risk edits.

Source 契约摘要 ​

该 source skill 未声明标准 Workflow Contract Summary 小节；本页以 frontmatter、supported-host governance 和维护者补充元数据为准。

何时使用 ​

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

工作步骤 ​

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

输出 ​

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

Agent 调度 ​

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

本 skill 当前没有 skill-local references/agents 或 references/personas 文件；默认由 orchestrator 直接完成，或按阶段需要临时调用其他 skill 的专家。

边界 ​

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

源码校准 ​

  • 本页由 website/scripts/generate-skill-detail-pages.js 从上游 source skill 生成。
  • 当前入口、兼容别名与宿主投递 metadata 来自 src/cli/contracts/dual-host-governance/skills-governance.json。
  • 当 source skill 或 governance contract 变化后，应重新运行 npm run reference:pages 并执行 npm run content:audit。