spec-kit

规范驱动开发（SDD）工具集。为 AI 编码助手（Claude Code / Codex）提供知识库骨架和技能包。

PyPI 发行名为 spec-kit-tool（spec-kit 与已有项目 speckit 撞名），安装后提供 spec-kit 命令。

pipx install spec-kit-tool
cd my-project
spec-kit install --agents claude-code,codex

组成

部署后的工作流

/context      → 加载上下文
/iteration    → 创建迭代
/prd          → 需求结构化
/design       → 方案设计
/research     → 技术调研（优先复用过往结论）
/dev          → TDD 实现
/fix          → Bug 修复
/change       → 轻量变更（微调/局部优化）
/complete     → 窗口提交

技能包

技能是跨 agent 的公共格式（Agent Skills 标准）。以下技能随 install 部署：

全局技能库

/complete 沉淀的技能写入 .spec/skills/，可推送到全局技能库（~/.spec-kit/skills/）供其它项目复用：

spec-kit skill push {name}          # 项目技能 → 全局库
spec-kit skill list                 # 列出全局库技能
spec-kit skill search {keyword}     # 搜索
spec-kit skill install {name}       # 全局库 → 当前项目所有声明 agent
spec-kit skill remove {name}        # 从全局库移除

支持的 CodingAgent

版本

spec-kit version

开发与发布（维护者）

发布流程分两步，凭据从本地 .env.release 读取（已 gitignore，模板见 .env.release.example）：

python scripts/release.py                 # 版本递增（默认 patch+1；--major/--minor/--patch/--to X.Y.Z）
python -m build                           # 构建 wheel + sdist
python scripts/publish.py                 # 上传 TestPyPI（测试环境）
python scripts/publish.py --prod          # 上传正式 PyPI
python scripts/publish.py --check-only    # 仅 twine check

.env.release 需分别配置 TestPyPI 与正式 PyPI 的 token：

TESTPYPI_USERNAME=__token__
TESTPYPI_PASSWORD=pypi-xxx
PYPI_USERNAME=__token__
PYPI_PASSWORD=pypi-yyy

许可

MIT