Metadata-Version: 2.4
Name: spec-kit-tool
Version: 1.4.1
Summary: 规范驱动开发（SDD）工具集：安装知识库骨架、部署 AI 技能与命令
License: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=7; extra == "dev"

# spec-kit

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

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

## 组成

| 组件 | 说明 |
|------|------|
| `spec-kit install` | 部署 `.spec/` 知识库骨架 + 按 agent 部署技能到对应目录（`--agents` 指定或交互式多选） |
| `spec-kit upgrade` | 升级已有安装 |
| `spec-kit uninstall` | 回收已部署的技能 |
| `spec-kit scan` | frontmatter 检索与发现（层级树） |
| `spec-kit lint` | 全面一致性校验 |
| `spec-kit metrics` | 项目健康指标查看 |
| `spec-kit skill` | 全局技能库管理（list/search/push/install/remove） |
| `spec-kit version` | 版本信息 |

## 部署后的工作流

```
/context      → 加载上下文
/iteration    → 创建迭代
/prd          → 需求结构化
/design       → 方案设计
/dev          → TDD 实现
/fix          → Bug 修复
/complete     → 窗口提交
```

## 技能包

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

| 技能 | 说明 |
|------|------|
| `prd` | 需求结构化 — 多阶段并行 Agent 管道 |
| `design` | 方案设计 — 全栈编排，先后端后前端 |
| `dev` | TDD 开发 — 骨架 → 测试 → 实现 |
| `fix` | Bug 修复 — 根因定位 → 方案 → 落地 |
| `complete` | 窗口提交 — 声明 + 域知识 + 规则 + 进度 + 技能沉淀 |
| `context` | 上下文加载 |
| `iteration` | 迭代初始化 |
| `checkout` | 迭代切换 |
| `grill-me` | 方案质询 |

## 全局技能库

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

```bash
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

| agent | 技能目录 |
|-------|----------|
| `claude-code` | `.claude/skills/` |
| `codex` | `.codex/skills/` |

## 版本

```
spec-kit version
```

## 许可

MIT
