Spec Kit 多运行时技能集
将 Spec Kit 的规格驱动开发工作流带到多个编码代理运行时。
- Star 数
- ★ 151
- 最近更新
- 1 天前
- License
- AGPL-3.0
- 主语言
- Shell
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 需要把 Spec Kit 规格驱动开发流程用于 Claude Code 或 Codex CLI 的开发者,可复用仓库中的共享技能。
- 不适合
- 只需要单一运行时原生安装包的团队
- 希望无需安装 Spec Kit 或运行时工具即可使用的人
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
该仓库维护 Spec Kit 生成内容,以及 skills/ 中的共享 speckit-* 技能和仓库专属技能。工作流涵盖项目原则、需求规格、计划、任务与实施,也提供澄清、分析、收敛、检查清单和任务转 GitHub Issues 等可选步骤。Claude Code 和 Codex CLI 通过指向 skills/ 的目录链接使用共享技能;Cursor Agent、GitHub Copilot CLI 和 OpenCode 使用各自生成的技能、代理、提示包装器或命令。仓库还保留 Gemini CLI 命令,但当前 CI 不会重新生成它们。使用者需安装 Spec Kit,并在目标项目中运行对应集成;此仓库提供技能与运行时入口文件,不是托管服务。
在工作流中,speckit-constitution 用于定义项目原则,speckit-specify 捕获新工作的需求,或用 speckit-baseline 从现有代码库推导规格;随后可运行 speckit-clarify 处理重要歧义,再由 speckit-plan 生成实施策略、speckit-tasks 生成有序任务,最后通过 speckit-implement 执行。可选的 speckit-analyze 检查规格、计划与任务的一致性,speckit-converge 将实现与这些材料比较并把剩余工作追加至 tasks.md,speckit-checklist 检查需求质量,speckit-taskstoissues 将任务转换为 GitHub Issues。CI 检查最新 Spec Kit 版本,并在版本变化时为配置的集成重新生成文件。
- 需要把 Spec Kit 规格驱动开发流程用于 Claude Code 或 Codex CLI 的开发者,可复用仓库中的共享技能。
- 需要从已有代码库整理规格的团队,可在新建计划前使用
speckit-baseline。 - 使用 Cursor Agent 的开发者,可采用
.cursor/skills/中生成的 Cursor 技能副本。 - 使用 GitHub Copilot CLI 的团队,可从
.github/agents/和.github/prompts/使用生成的代理与提示包装器。 - 使用 OpenCode 的开发者,可调用
.opencode/commands/中的生成命令,并按需检查与更新任务。
如何安装或部署这个 Agent?
先克隆仓库并安装 Spec Kit;再在目标项目中使用相应集成初始化。README 未提供 Spec Kit 的具体安装命令、版本要求或运行时认证步骤。要在直接消费 Agent Skills 的目标运行时中使用技能,可按需复制共享技能:
git clone https://github.com/dceoy/speckit-agent-skills.git
cd speckit-agent-skills
# Install Spec Kit using its documented installation method.
# Then, from the target project:
specify init --here --integration <integration>
# If the target runtime consumes Agent Skills directly:
cp -a skills/* /path/to/project/skills/如何使用这个 Agent?
在目标项目中运行初始化命令时,将 <integration> 替换为所需集成。仓库 CI 当前配置的集成为 codex、agy、cursor-agent、copilot、opencode 和 claude。之后通过所用代理的技能调用流程或运行时命令调用对应的 speckit-* 技能;技能不一定会自动运行。
specify init --here --integration <integration>这个 Agent 有哪些优点和局限?
- 共享
skills/同时通过目录链接提供给 Claude Code 与 Codex CLI,便于维护同一套技能。 - 包含从
speckit-baseline推导现有代码规格的路径,以及从规格到实施的主要流程。 - CI 根据记录的 Spec Kit 版本变化再生成输出,并覆盖多个明确配置的集成。
- 使用前需要安装 Spec Kit,并为目标项目选择并运行相应集成初始化。
- 生成文件按运行时分布在不同目录;Cursor、Copilot 和 OpenCode 的入口并非都使用同一种布局。
- Gemini CLI 命令虽已检入,但不在当前 CI 再生成范围内;旧版运行时目录也不再维护。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Spec Kit 多运行时技能集 当前 | 51 · 缺口较多 | Agent 插件 / 技能 | ★ 151 | 1 天前 | Shell | Codex · Claude Code |
| AI-DLC 工作流引擎 | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5.5k | 今天 | TypeScript | Codex · Claude Code |
| Claudexor | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 516 | 今天 | TypeScript | Codex · Claude Code |
| EOC — Everything OpenAI Codex 工作流操作系统 | 75 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 86 | 4 个月前 | JavaScript | Codex |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
工作流声明了 contents:read 基础权限,并对再生成任务单独授予 contents:write 与 pull-requests:write;但 Dependabot 自动合并设为 unconditional,且材料没有说明运行时技能的权限、确认、数据流、敏感数据处理或回滚方式,因此这些方面仅给部分分。锁文件固定了若干 Actions 到提交哈希,故依赖安全有一定依据;外部副作用包括提交生成结果及自动合并,但缺少相应恢复说明。README 将 Spec Kit 指为上游并说明版本记录方式,支持来源追溯;发布者身份和维护责任仍不清楚,未据此加分。
README 描述的集成目录与工作流配置大体相符,也指出 Gemini 不在当前再生成集合中,因此内部一致性较好但并非充分交叉验证。更新依赖 Spec Kit 最新发布和外部运行时工具,README 列出了前置条件,却未提供可用性保障。文档建议技能失败时检查 SKILL.md 和项目结构,但没有具体错误信息或故障处理示例,故失败提示仅有薄弱支持。
README 给出了规范驱动开发的流程、可选步骤和多个 Agent 运行环境,覆盖常见场景;也指出技能不一定自动触发、应显式调用,且不同集成使用不同布局。触发条件只有概括性说明,具体技能何时适用无法从所给材料确认,因此触发精度扣分。环境说明较清楚,但实际技能内容未提供,不能证明更广泛的适配性。
README 以目录树、集成表、工作流图和再生成说明组织信息,结构清晰。Quickstart、前置条件、用法提示及旧布局说明提供了实用入门信息,但没有 FAQ 或具体技能示例。AGPL-3.0 的完整许可证文本明确,版本由 VERSION.md 跟踪且有自动更新流程;材料没有变更日志,也未明确谁负责维护,故版本与责任项未给满分。
README 描述了从原则、需求到计划、任务和实现的工作流,并列出清单与任务转 issue 等工具,显示出潜在增值。实际输出样例、质量证据和运行成本没有提供,无法确认输出可直接使用或成本收益,因此相关评分偏低。
关键布局、集成和再生成说法可在 README 中追踪,工作流文件支持其中一部分集成配置;但不同文件之间的独立佐证有限,且没有技能正文、测试结果或执行证据。文档通常把当前配置和建议作为描述呈现,但未提供足以核实所有产品行为的材料,故不给满分。
- 所给材料未包含实际技能正文,无法静态核查技能指令、具体权限或输出行为。
- CI 再生成可写仓库并创建或更新拉取请求;另有 unconditional Dependabot 自动合并配置。使用者应先审阅这些工作流的目标仓库和合并条件。
常见问题
这个仓库是在线服务还是可以直接接入项目的技能?
specify init,或按目标运行时需要复制技能。哪些运行时有明确的集成?
codex、agy、cursor-agent、copilot、opencode 和 claude。README 说明 Gemini 命令已检入,但不由当前 CI 重新生成。技能会自动执行吗?
如何处理执行失败?
SKILL.md,并确认项目具备所需的 Spec Kit 目录结构和前置条件。