Archive228/loopkit
GitHub: Archive228/loopkit
一套包含 33 个实战技能的 AI 编程 Agent 增强工具包，通过条件触发式技能加载让代码助手输出更规范、更可靠的代码。
Stars: 461 | Forks: 83
# loopkit
**一个精选的库，包含 33 个经过实战检验的技能，可让任何编写代码的 agent 交付更整洁的代码——并停止盲目猜测。**
将它们放入 `.claude/skills/`（或任何读取 SKILL.md 的 agent）中，你的 agent 只会在相关时加载每个技能：系统性 debug、进行 security 审查、设计真实的 UI、在精益循环中运行 agent、优先编写失败的测试、交付干净的 commit。
```
curl -fsSL https://raw.githubusercontent.com/Archive228/loopkit/main/install.sh | bash
```
兼容 **Claude Code · Cursor · Codex · Gemini CLI**。基于 Anthropic 发布的 agent 工程模式（[Building Effective Agents](https://www.anthropic.com/research/building-effective-agents)，Claude Code 文档）构建——提炼为你可以直接引入的技能。
## 安装程序会写入什么
写入到你的当前目录：
- `.claude/CLAUDE.md` — 60 行固定上下文
- `.claude/settings.json` — 权限白名单 + 写入时格式化 hook
- `.claude/agents/verifier.md` — 对抗性 verifier 子 agent
- `.claude/skills/` — 33 个技能文件（仅在触发时加载）
- `.mcp.json` — MCP server 配置
- `MEMORY.md` — 跨会话记忆索引
- `run.sh` — Plan→Act→Verify 循环执行器
默认保留现有文件。传入 `FORCE=1` 以覆盖：
```
curl -fsSL https://raw.githubusercontent.com/Archive228/loopkit/main/install.sh | FORCE=1 bash
```
或者克隆并手动复制：
```
git clone https://github.com/Archive228/loopkit
cp -r loopkit/.claude loopkit/skills loopkit/.mcp.json loopkit/MEMORY.md loopkit/run.sh your-project/
```
## 为什么需要技能
一个原始的 agent 会进行猜测。当它猜测时，就会捏造事实——虚构的 API、毫无意义的通过测试、仅仅是重命名的“修复” bug。技能是一套紧凑、可重用的指令集，仅在其触发条件匹配时加载，因此 agent 会变得专精，而不是凭空发挥——同时无需在每个 prompt 上为每个技能支付 token。
## 技能库（33 个技能，9 个轨道）
| 轨道 | 技能 |
|---|---|
| **agent/llm** | context-budget · spec-first · tool-restraint · subagent-fanout |
| **debug** | systematic-debugging · read-the-trace · bisect-regression |
| **security** | owasp-review · authz-check · input-validation · secret-scan · dependency-audit |
| **frontend** | design-system · a11y-pass · loading-empty-error-states |
| **testing** | write-failing-test-first · flaky-hunter · coverage-gaps · contract-test |
| **refactor** | kill-dead-code · simplify · reduce-nesting |
| **docs** | changelog-from-diff · decision-record · readme-audit |
| **data** | sql-review · migration-writer · schema-diff |
| **git/ops** | clean-commits · pr-from-diff · rebase-safely · revert-surgical |
| **review** | adversarial-verify（agent 用来伪装“完成”的 11 种捷径） |
每个技能：一项专注的技术，而不是教程。阅读其中一个，fork 它，把它变成你自己的。
## 额外奖励：harness
`init` 还会部署一个最小化可用的 `.claude/`（固定上下文、权限白名单、写入时格式化 hook、verifier 子 agent、MCP 配置、记忆索引）以及一个 Plan→Act→Verify 循环执行器——这是你的技能运行的基础平台。完整理论：**Loop and Harness engineering：7 个文件，5 个步骤**。
MIT。专为被 fork 而生。
标签：AI编程助手, Claude Code, Cutter, SOC Prime, 人工智能, 开发工具, 提示词工程, 用户模式Hook绕过, 策略决策点, 自定义脚本, 防御加固