misty-step/harness-kit
GitHub: misty-step/harness-kit
一个集成了多种安全技能和代理的自动化安全工具库。
Stars: 13 | Forks: 3
# Harness Kit
29个目录技能,11个核心代理,以及AI辅助软件开发的基础设施。一个仓库。所有工具(Claude Code,Codex,Pi,Antigravity)。
Harness Kit是一个面向操作员的工具库,而不是面向购买者的管理流程包或管理控制平面。在为客户端、部门、采购、安全审查员或高管构建此仓库之前,请先阅读
[`docs/positioning.md`](docs/positioning.md)。
## 快速开始
```
# Bootstrap (每台机器一次)
# 安装第一方技能、同步外部技能和提供商名单
# 系统范围;如果存在本地检出,则创建符号链接,否则下载 Rust 源代码
curl -sL https://raw.githubusercontent.com/misty-step/harness-kit/master/bootstrap.sh | bash
```
如果您从临时的git工作树运行bootstrap,它现在自动优先选择稳定的检出,例如`~/Development/harness-kit`。要故意将您的工具指向特定的检出,请设置
`HARNESS_KIT_DIR=/path/to/harness-kit`。
新机器的bootstrap需要Rust工具链,除非`harness-kit-checks`已经安装到`PATH`。
## 核心工作流程技能
| 技能 | 目的 |
|-------|---------|
| `/deliver` | 内循环作曲家:票据 → 合并就绪(形状 → 实现 → 审查+ci+重构+qa) |
| `/flywheel` | 外循环协调器:/deliver → /monitor → /reflect的周期 |
| `/code-review` | 并行多代理审查,自动修复循环 |
| `/diagnose` | 调查,分类,修复 |
| `/qa` | 验证更改后的表面并捕获证据 |
| `/hardening` | 属性测试,突变测试,CRAP/SCRAP,DRY,以及接受突变 |
| `/demo` | 使用正确的工件展示更改 |
| `/design` | 对层次结构、排版、布局和品味的工件支持的批评和润色 |
| `/monitor` | 监视更改后的信号并升级回归 |
| `/groom` | 后台管理,头脑风暴,重新思考,脚手架 |
| `/harness-engineering` | 技能工程,原语管理,上下文生命周期 |
| `/create-repo-skill` | 生成本地QA、角色接受和定制工作流程技能 |
| `/reflect` | 会话回顾,工具后事分析,操作员辅导 |
| `/research` | 多源网络研究,委派,智库 |
| `/shape` | 规范/设计 → 上下文数据包输出 |
## 8个核心代理
**GAN三联组:** 规划师(规范)→ 建造者(实现)→ 批评家(评估)
**设计审查台:** ousterhout(深度),carmack(发货),grug(简洁),beck(TDD),cooper(经典测试)
## 工作流程
```
backlog.d/ → /groom → /shape → /deliver → ship
└─ /flywheel (outer loop cycles:
/deliver → /monitor → /reflect → next)
```
要了解存储库架构的更详细地图、编码假设、操作循环和活动后台,请阅读[`CODEBASE.md`](CODEBASE.md)。
## 静态文档伴侣
Harness Kit的公共静态文档伴侣是从实时仓库源生成的:
```
cargo run --locked -p harness-kit-checks -- build-docs-site
cargo run --locked -p harness-kit-checks -- check-docs-site --self-test
```
打开[`docs/site/index.html`](docs/site/index.html)以查看渲染的网站。
面向公众的副本位于[`docs/copy/site.json`](docs/copy/site.json)。
源更改通过pre-commit自动重新生成网站;CI在漂移时失败。
生成的目录包括每个本地技能和代理、CI门控图、工作流程演练、治理说明以及代理可读的
[`docs/site/llms.txt`](docs/site/llms.txt)。
部署在生成网站检查通过后从`master`发布`docs/site`到GitHub Pages。
## 结构
```
harness-kit/
├── skills/ # Canonical skill catalog
├── agents/ # Agent definitions
├── harnesses/ # Per-harness configs (claude/, codex/, pi/, antigravity-cli/, antigravity-ide/)
│ └── shared/ # Common engineering principles
├── registry.yaml # Pinned external skill sources for sync/search
└── bootstrap.sh # Curl-compatible launcher for the Rust bootstrap command
```
## 添加技能
1. 创建`skills/{name}/SKILL.md`并包含元数据
2. 保持其长度小于500行。编码判断,而不是程序。
3. 运行`/harness-engineering lint`以验证质量门
4. 运行`cargo run --locked -p harness-kit-checks -- bootstrap`或
`./bootstrap.sh` — bootstrap会自动从文件系统中发现技能
## 原则
- **薄技能,强代理** — 抵制仪式
- **陷阱 > 指令** — 列举出错的情况
- **去除非承重脚手架** — 在模型升级后进行压力测试
- **符号链接,而不是复制** — Rust bootstrap在可用时链接到本地检出
- **渐进式披露** — 描述 → SKILL.md → 参考
## 许可证
MIT
标签:可视化界面, 网络安全研究, 请求拦截, 通知系统