Trade-With-Claude/bolt-framework
GitHub: Trade-With-Claude/bolt-framework
BOLT 是 Claude Code 的轻量级项目管理框架，通过强制闭环、零子代理设计和 git 版本标记，帮助开发者在 AI 辅助下可控地完成从创意到上线的完整应用开发。
Stars: 0 | Forks: 0
# BOLT — Claude Code 的精益项目管理
BOLT 是一个为 Claude Code 设计的轻量级项目管理框架。它将所有内容保持在会话中（构建时不使用 subagents），包含 16 条命令，并强制执行循环闭环。
## 安装
```
git clone https://github.com/Trade-With-Claude/bolt-framework.git
cd bolt-framework
./install.sh
```
这会将 16 个命令文件复制到 `~/.claude/commands/bolt/`。
## 升级
```
cd bolt-framework
git pull
./install.sh
```
然后在你的项目中，如果结构发生变化：
```
/bolt:upgrade
```
这会更新 `~/.claude/commands/bolt/` 中的命令文件 — 你的项目文件永远不会被修改。
## 快速开始
```
/bolt:init Dimension # Create project folder + IDEA.md
# 填写 .bolt/v1/IDEA.md 与您的愿景
/bolt:discover # Deep Q&A about your project
/bolt:research # Deep technical research
/bolt:roadmap # Break into phases
/bolt:plan 1 # Plan first phase
/bolt:build 1 # Build it
/bolt:close # UNIFY — close the loop (mandatory)
```
## 工作流
```
init → discover → research → roadmap → plan → build → close
↑ |
└──────────────────┘
(next phase)
All phases done? → /bolt:next → new version cycle
```
## 命令
| 命令 | 描述 |
|---------|-------------|
| `/bolt:init ` | 创建带有 .bolt/ 结构的项目文件夹 |
| `/bolt:discover` | 深度问答，用于理解项目 |
| `/bolt:research` | 并行 agent 驱动的技术研究 |
| `/bolt:roadmap` | 将项目分解为多个阶段 |
| `/bolt:plan ` | 规划第 N 阶段的任务和标准 |
| `/bolt:build ` | 执行阶段计划并进行内联验证 |
| `/bolt:close` | UNIFY — 协调计划与实际情况 |
| `/bolt:next` | 标记版本，开始下一次迭代 |
| `/bolt:push` | 快速保存 — git add, commit, push |
| `/bolt:upgrade` | 将旧版 .bolt/ 迁移到最新 schema |
| `/bolt:status` | 显示进度，建议下一步操作 |
| `/bolt:resume` | 返回后重新加载上下文 |
| `/bolt:pause` | 离开前的完整交接 |
| `/bolt:clear` | 当窗口负载较重时的快速上下文保存 |
| `/bolt:verify` | 可选的 UAT 演练 |
| `/bolt:help` | 命令参考 |
## 设计原则
- **无 subagents** — 所有内容均在会话中运行（每避免一个 subagent 约节省 3k tokens）
- **16 条命令** — 精简但完整
- **强制 UNIFY** — 每次 `/bolt:build` 后必须执行 `/bolt:close`
- **每个计划 2-3 个任务** — 适配约 50% 的上下文窗口
- **唯一下一步操作** — 每条命令仅建议一个下一步
- **上下文括号** — 随着上下文填充调整行为
- **版本化迭代** — v1, v2, v3... 带有 git tags 以便轻松回滚
## 项目结构
执行 `/bolt:init` 后，你的项目将包含：
```
my-project/
├── .bolt/
│ ├── SCHEMA # Schema version (for upgrades)
│ ├── PROJECT.md # Living doc — persists across versions
│ ├── STATE.md # Tracks current version
│ └── v1/
│ ├── IDEA.md # Your vision for v1
│ ├── ROADMAP.md # Phases with requirements
│ ├── STATE.md # V1 progress
│ └── phases/
│ └── 01-name/
│ ├── 01-01-PLAN.md
│ └── 01-01-SUMMARY.md
```
## 版本管理
```
/bolt:next # Tag v1, create v2 folder
git checkout v1 # Go back to v1 anytime
/bolt:upgrade # Migrate old projects to new structure
```
## 会话管理
| 情境 | 命令 |
|-----------|---------|
| 离开数小时/数天 | `/bolt:pause` — 完整交接 |
| 上下文变得沉重 | `/bolt:clear` — 快速保存 |
| 回到工作中 | `/bolt:resume` — 重新加载上下文 |
| 迷失或困惑 | `/bolt:status` — 查看当前位置 |
| 保存进度 | `/bolt:push` — git commit + push |
标签：AI 编程, BOLT, Claude Code, CLI 工具, Cutter, Git, Linux 内核安全, LLM 框架, MVP 开发, Shell 脚本, Trade-With-Claude, 上下文管理, 代码生成, 任务自动化, 安全可观测性, 提示词工程, 敏捷开发, 智能体工作流, 渗透测试工具, 版本控制, 生命周期管理, 研发效能, 策略决策点, 网络安全研究, 软件开发, 防御加固, 项目管理