spec-runtime-setup

安装、配置并验证 Claude Code、Codex、Cursor、Kiro、Qoder、OpenCode 所需的 spec-first harness runtime、required MCP、helper tools 与 CodeGraph / Graphify provider readiness。

ASCII 链路图

Codebase -> Spec -> Plan -> Tasks -> Code -> Review -> Knowledge
    |
    v
    spec-runtime-setup
    entry: spec-runtime-setup
    type: workflow command

基本信息

字段	内容
Skill	spec-runtime-setup
类型	workflow command
研发链路位置	Codebase
当前入口	spec-runtime-setup
兼容别名	/spec:runtime-setup、$spec-runtime-setup
Source	skills/spec-runtime-setup/SKILL.md
Governance	src/cli/contracts/dual-host-governance/skills-governance.json（supported-host skills governance）

描述

Install, configure, verify, and refresh required harness runtime readiness facts for spec-first workflows on Claude Code, Codex, Cursor, Kiro, Qoder, or OpenCode.

Source 契约摘要

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

何时使用

• 第一次接入项目。
• Required MCP、helper CLIs 或 runtime capabilities 缺失。
• 需要完成或修复包含 CodeGraph / Graphify 的完整 setup baseline；--only 仅用于高级子集修复。
• host readiness 需要修复。

工作步骤

• 读取 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 的专家。

边界

• 不提供代码理解权威；下游仍要用 bounded direct source reads、rg、ast-grep、git diff、tests/logs 和用户证据确认结论。
• 修改 host runtime 前必须遵守当前 host 的权限和配置边界。

源码校准

• 本页由 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。