用 Spec Kit 初始化胶囊系统项目HERMES & AGENT ENGINEERING · 课时 04

4.1 执行 specify init

现在给 Codex 一条明确的初始化指令：

请使用 Spec Kit 在 `~/Desktop/Project` 下初始化一个名为 `capsule-system` 的项目，开发 Agent 选择 Codex。如果同名目录已经存在，先不要覆盖。

这里不需要把 specify init 的参数逐个写进提示词。只要明确项目路径、项目名称和使用的开发 Agent，Codex 就可以根据当前安装的 Spec Kit 版本完成初始化。

命令执行完成后，终端会返回：

到这里，capsule-system 目录才真正被创建出来。

4.2 项目结构

初始化完成后，胶囊系统目录里还没有业务代码。而且你看到的目录可能是空目录，因为默认的文件均是以.开头的隐藏文件。但是我们可以通过：

ls -a 查看这些隐藏目录和文件。

同时，我们可以测试，在 Codex 里输入$，已经出现了我们需要的 SKILL：

现在看到的，是 Spec Kit 为后续开发准备的基础结构。下面只列出本章会用到的主要目录和 skills：

capsule-system/
├── .agents/
│   └── skills/                    ← Codex 使用的 speckit skills
│       ├── speckit-constitution/
│       ├── speckit-specify/
│       ├── speckit-plan/
│       ├── speckit-tasks/
│       ├── speckit-implement/
│       └── speckit-converge/
└── .specify/
    ├── memory/
    │   └── constitution.md       ← 项目宪章，后续步骤开始写
    ├── scripts/bash/                ← 创建规范、计划和任务的辅助脚本
    ├── templates/                   ← SPEC、plan、tasks 等文档模板
    ├── workflows/                   ← Spec Kit 工作流配置
    ├── init-options.json            ← 本次初始化选项
    └── integration.json             ← Codex 集成信息

这里有两个目录需要区分。.agents/skills/ 里放的是当前项目使用的 Spec Kit Skill，.specify/ 里放的是项目宪章、文档模板、辅助脚本和工作流配置。它们都是开发工具，不是胶囊系统的业务代码。

这些 Spec Kit Skill 只安装在 capsule-system 项目中，属于项目局部 Skill。它们不会进入 ~/.codex/skills/，也不会自动出现在其他项目里。后面只有从胶囊系统目录启动 Codex，Codex 才能发现并引用它们。

初始化阶段也不会提前生成 spec.md、plan.md 和 tasks.md。后面向 Codex 输入 $speckit-specify 以后，Spec Kit 才会创建 specs/ 目录，再把每个功能的规范、技术方案和任务清单放进去。这些产物主要是 Markdown 文件，后面可以和代码一起交给 Git 管理。

4.3 从项目目录打开 Codex

先执行下面的命令，确认 .agents/skills/ 中确实存在 speckit-* 目录：

ls ~/Desktop/Project/capsule-system/.agents/skills

本章的项目会列出 speckit-constitution、speckit-specify、speckit-plan 等目录。看到这些目录，说明 Spec Kit Skill 已经写入项目。

进入新的 Codex 会话后，在输入框中输入一个 $，暂时不要提交。候选列表中应该出现 $speckit-constitution、$speckit-specify、$speckit-plan 等名称。到这里，才说明 Codex 已经发现这些 Skill，后面可以通过 $Skill名称 引用它们。

如果 .agents/skills/ 中已经存在 speckit-* 目录，但输入 $ 仍然没有提示，先检查当前 Codex 是否从 ~/Desktop/Project/capsule-system 启动。

4.4 准备就绪

现在，Spec Kit 已经安装，胶囊系统的开发目录也初始化完成。Codex 已经进入这个目录，也能读取 Spec Kit 提供的项目工作流。

下一步先制定胶囊系统的项目宪章。宪章暂时不写具体功能，它先把这个项目必须长期遵守的原则定下来。后面的功能规范、技术方案和实现，都不能违反这些原则。

4.5 ■ 学点英语