@dtlabs/ai-toolkit — 大赦国际工具包
可重复使用的Claude代码代理,技能,命令,以及端到端的软件特性交付和代码库评估程序——从要求到PR,从审计到补救.
来见见Gaia——你的工具包助理
一旦安装,最好的开始方式是说:
/hi-gaia
盖亚 是工具包的内置助手。 她自我介绍,扫描你的工作空间以了解背景(项目已经设置了吗? 并引导你走向正确的工具.
您也可以直接询问她具体的主题:
/hi-gaia feature → how to build a new feature end-to-end
/hi-gaia assess → how to audit and improve an existing codebase
/hi-gaia setup → how to onboard a new project
/hi-gaia agents → full catalog of available agents and skills
如果你不确定该用哪个指令或代理,盖亚就是正确的起点. 她不会运行任何东西——她帮助你理解工具包,并决定下一步要做什么.
它提供的东西
两个独立的管道:
特性输送管道
- 12名探员 完成整个交付生命周期(要求-技术-类别-工作故障-后端/前端/测试实施-建筑师审查)
- 5个技能 可通过斜线命令(
/install-toolkit, (中文(简体) ),/init-agents, (中文(简体) ),/implement-feature, (中文(简体) ),/define-feature, (中文(简体) ),/hi-gaia(中文(简体) ) - 4个命令 用于快速的日常快捷键( :
/feature-status, (中文(简体) ),/check-docs, (中文(简体) ),/pr-description, (中文(简体) ),/next-task(中文(简体) )
评估和补救管道
- 10名代理人 编码基础评估和定向补救(基因评估、分层审计、货币安全、神类分解、DI重构、域模型重构、安全强化、供应链安全、干预文件)
- 1个技能 (单位:千美元)
/assess-codebase在任何代码更改之前,使用人批准门运行完整的评估管道 - 1个命令 (单位:千美元)
/assessment-status用于检查正在进行的评估状况
共享
- 4个通用程序 (代码生成、代码审查、安全编码、测试)项目可以覆盖本地
安装
当地安装 (计入当前项目):
npx @dtlabs/ai-toolkit
全球安装 (进) ~/.claude/:
npm install -g @dtlabs/ai-toolkit
ai-toolkit --global
命令复制代理、技能、程序 CLAUDE.md 进入合适的地点.
如何运作
工具包船 通用剂 与任何项目。 每一代理机构都从下列来源阅读具体项目公约: AGENTS.md 中的文件。 运行 /init-agents 为新工程生成该文件.
通用程序在 docs/procedures/。项目可以通过将同名文件放在自己的位置来覆盖其中的任何项目 docs/procedures/特工先检查项目 然后回到工具箱.
所需的配置——子剂产卵深度
⚠️ 此设置对所规划的管道不是可选的 . 没有它,
/implement-feature财务报告和审定财务报表/assess-codebase默而贬之.
该工具包建立在 两级代理等级: 管弦乐演奏家(project-manager 或者说 assessment-manager)作为子剂被产出,它反过来又孕育出专门的工人代理人(开发者,审查者,评估者),每个代理人在自己适合的角色模式上都有孤立的背景.
克劳德代码以来 v2.1.217, 亚剂不能默认生成进一步的亚剂 (发作深度被封为1,故意防无约束回转扇出和成本. 在这种默认下,当一个管弦乐团作为副代理运行时,它有 没有 Agent 工具 因此,它不授权,而是执行每个工人的任务 在自己的背景中,根据自己的模式后果:
- 代理代理模式转让停止生效 - 那个
haiku编号 :sonnet编号 :opus对每种物剂的绘图从未应用过,因为这些物剂从未实际被产出. 一切运行在管弦乐队的模型. - 失去背景隔离 ——一长串管弦乐器上下文取而代之的是原意的逐剂隔离.
- 代理代号遥测消失 没有每名代理人
<usage>块被释放,所以*-Token-Estimate.md只记录了总和的管弦乐手总数.
为使工具包按设计发挥作用,提高允许的深度 2个 (主循环-管弦乐-工人). 这回波已经放进去了 .claude/settings.json数字 :
{
"env": {
"CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "2"
}
}
当您将工具包安装到另一个项目时, 您必须自己添加此设置 . 安装器npx @dtlabs/ai-toolkit, (中文(简体) ), ai-toolkit --global,则 /install-toolkit 代理人) 从不复制或编辑任何 settings.json – 该文件是用户拥有的, 并自动合并它会冒打乱您现有的配置的风险. 相反,每个安装器 检查 是否为 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH 设置为 2+ 在目的地,如果缺少,则打印要添加的确切片段(至 .claude/settings.json 用于一个项目,或 ~/.claude/settings.json (关于所有项目)。 在添加后, 重新启动 Claude 代码, 使变量被加载 .
管弦乐的特工已经省略了 tools: 前题字段,所以它们继承 Agent 一旦深度允许,工具就自动生效——不需要每个代理更改.
发展
正在本地测试
npm install # install devDependencies (jest, gray-matter)
npm test # run all tests; stops at first failure (--bail)
npm run test:coverage # run all tests and generate a coverage report
测试套房包括:
tests/cli/- 单位测试纯函数bin/cli.js(单位:千美元)fileHash, (中文(简体) ),walkDir, (中文(简体) ),expandMappings, (中文(简体) ),categorize, (中文(简体) ),readInstalledVersion(中文(简体) )tests/frontmatter/——所有项目的结构验证.claude/agents/*.md财务报告和审定财务报表.claude/skills/**/SKILL.md前题字段
覆盖面积报告 coverage/ (恶作剧). 打开 coverage/index.html
在浏览器中浏览行级覆盖。 没有实施覆盖门槛;
报告只是诊断.
中情局
GitHub 动作工作流程(.github/workflows/ci.yml自动运行
每次拉动请求都瞄准 main数字 :
- 检查重播
ubuntu-latest带节点 20 - 安装依赖关系
npm ci - 运行
npm test——如果测试失败, 公关检查为红色 - 运行
npm run test:coverage上传coverage/作为目录 30天工作流程文物
添加或更改测试
- 当您修改函数时
bin/cli.js,更新匹配测试文件 内tests/cli/。 。 。 . - 当添加代理
.md或技能SKILL.md前题测试tests/frontmatter/自动运行 —— 确保 需要的字段(name, (中文(简体) ),description, (中文(简体) ),model代理人;description(a) 具备并有效.
文档
- 快速引用 - 每种技能、指挥、代理和程序的欺骗表
- 安装指南 ——满
.npmrc设置和 CLI 选项 CLAUDE.md- 代理和技能参考docs/procedures/——可再使用的工作流程
许可证
麻省理工学院