欢迎使用 CodexSpec

一款专为 Claude Code 打造的规格驱动开发（SDD）工具包

CodexSpec 是一款工具包，帮助你使用结构化的、规格驱动的方法来构建高质量软件。它颠覆了传统开发模式，将规格说明转化为可执行的工件，直接指导实现过程。

为什么选择 CodexSpec？

为什么在 Claude Code 之上使用 CodexSpec？以下是对比：

维度	只使用 Claude Code	CodexSpec + Claude Code
多语言适配	默认英文交互，非英语用户体验不佳	配置团队语言，交互和审阅更顺畅高效
可追溯性	会话结束后难以追溯历史决策	.codexspec/specs/ 保存所有规格、方案、任务
会话恢复	plan mode 误操作会话中断，恢复困难	多命令拆分 + 持久化文档，随时恢复进度
团队治理	无统一原则约束，风格不统一	constitution.md 定制团队原则，保持质量风格统一

人机协作

CodexSpec 的核心理念是：有效的 AI 辅助开发需要在每个阶段都有人类的主动参与。

问题	解决方案
需求不清晰	在构建之前通过交互式问答进行澄清
规格说明不完整	专用的审查命令，带有评分功能
技术方案与意图偏离	基于 Constitution（宪法）的验证机制
任务分解模糊	强制 TDD 的任务生成

核心特性

• Constitution 驱动 - 建立项目原则，指导所有决策
• 交互式澄清 - 基于问答的需求细化
• 审查命令 - 在每个阶段验证工件
• TDD 就绪 - 内置测试优先的任务方法论
• i18n 支持 - 通过 LLM 翻译支持 13+ 种语言

快速开始

# 安装
uv tool install codexspec

# 创建新项目
codexspec init my-project

# 或在现有项目中初始化
codexspec init . --ai claude

完整安装指南

工作流程概览

想法 -> 澄清 -> 审查 -> 规划 -> 审查 -> 任务 -> 审查 -> 实现
            ^              ^              ^
         人工检查        人工检查        人工检查

每个工件都有对应的审查命令，在继续之前验证 AI 输出。

了解工作流程

许可证

MIT 许可证 - 详情请参阅 LICENSE。