Spec-First

spec-standards ​

编译 graph-backed project standards 和 glue capability baseline。

基本信息 ​

字段内容
Skillspec-standards
类型workflow command
研发链路位置Codebase
入口/spec:standards / $spec-standards
Sourceskills/spec-standards/SKILL.md

描述 ​

Compile graph-backed project standards and glue capability baseline artifacts from project facts, shared standards inputs, and observed code conventions. Use when onboarding a brownfield project, refreshing project-level standards, preparing reusable project baselines before planning/work/review, or importing team/shared engineering standards for project confirmation.

何时使用 ​

  • brownfield 项目需要规范基线。
  • 下游 workflow 需要项目约束、reuse-first 边界或 shared standards。

工作步骤 ​

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

输出 ​

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

Agent 调度 ​

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

边界 ​

  • confirmed 才是硬约束。
  • observed/imported/suggested/unknown 只能作为 advisory context。