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

多工具共享目录（如 .agents/skills）不纳入部署范围 —— 卸载边界与同源保护无法界定。

版本

spec-kit version 输出包版本（本工具的发布版本，权威值见 pyproject.toml 与 CHANGELOG.md）。

它与 .spec/iteration/ 下的迭代标识是两条正交的轴，不要互相换算：

本仓自身的历史迭代沿用了 v2.x.x 形式，与包版本同形 —— 读 commit / CHANGELOG 时容易误读。 新迭代请按上表命名；仓库自己的工作流迭代记录在 .spec/iteration/，不在 CHANGELOG 里。

spec-kit version

开发与发布（维护者）

提交门禁

仓库自带 pre-push 门禁（scripts/gate.py：lint + pytest），逻辑与 CI 共用同一份脚本。 新克隆后启用一次（hook 不像普通文件那样随 clone 生效）：

git config core.hooksPath .githooks

跳过单次：git push --no-verify。

发布

发布流程分两步，凭据从本地 .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