github地址:
👉 https://github.com/grid-oaa/codex-skill-spec


一、Kiro 的 Spec 是什么?

在没有 Spec 的情况下,我们经常这样工作:

给一句模糊需求 → 各自理解 → AI 或开发开始干活 → 结果经常跑偏

有使用过 Kiro 的小伙伴会知道,Krio 的 Spec 模式,会依次会生成 requirements.md、design.md、tasks.md三个文档。

requirements.md 文档用来描述项目的具体需求,包括项目背景、目标、功能需求、预期成果等。

design.md 文档专注于项目的架构和技术设计方案。

tasks.md 文档是规划和跟踪项目开发过程中的各项任务。

有了 tasks.md 文档后,我们只需要点击 start task 即可开始执行任务了。

总结一下:Spec 的作用就是把: 「需要 AI 去猜的东西」→ 变成「AI 可以直接执行的文档信息」


二、Codex Skill是什么?

熟悉 Claude Code Skills 的小伙伴应该不会默认了,Skill 好比一个封装好的函数,可以反复调用。它可以按固定方式、稳定地完成某一类任务。

在 Codex 中输入$就可以查看到可使用的 Skill 了,选中某一个后就可以使用该Skill能力了。


三、Codex Skill Spec实战示例

从 Github 仓库(https://github.com/grid-oaa/codex-skill-spec)下载后,在 skills 目录下有 design、requirements、tasks 三个文件夹。

(code-review-pro 是我代码审查的 skill,感兴趣的也可以添加上。)

把这三个文件夹复制到你的 codex 安装目录下的skills目录下

windows示例:C:\Users\Lenovo.codex\skills

然后打开codex,输入$就能看到了。(如果你的 codex 还不支持 skill,将 codex 升级成最新版)

使用案例:

1、生成 requirements.md 文档

输入$,选择 requirements 后,输入你的开发需求

--module 是我自定义的参数,是用来指定将生成好的 requirements.md 文档放到当前项目doc下的哪个目录下。

然后 codex 会向你询问有关需求的详细设计要求,回复后就会生成 requirements.md 了。

2、生成 design.md 文档

输入$,选择 design 后,只需输入 --module user即可。

design会根据 user目录下的 requirements.md 文档来做设计

3、生成 tasks.md 文档

输入$,选择 design 后,只需输入 --module user即可。


之后你就可以告诉 ai 来执行 tasks.md 中的某一个任务了。

**强烈建议!:**使用另外的一个 ai 来对任务的执行情况进行监督,可以参考 tasks-detail.md 中的模板及提示词。

使用必看

生成md文件使用的是node.js,一定要提前安装!