Agents Init

代理初始化

一次性初始化代理文档+技能/MCP/子代理

agents-init 是一个CLI工具，可以引导您的存储库进行人工智能辅助开发。它分析您的代码库，检测技术，并自动配置：

• 代理商.md -AI编码助手的供应商中立指南
• CLAUDE.md -源AGENTS.md的Claude代码配置
• .mcp.json -模型上下文协议服务器配置
• 子代理 -专业AI助手 .claude/agents/
• 技能 -Claude为您的堆栈编写代码的技能
• /代理初始化 -Slash命令以重新生成配置

如果代理工具的速度很难跟上，那么你并不孤单。 “作为一名程序员，我从未感到如此落后。”——Andrej Karpathy https://x.com/karpathy/status/2004607146781278521

______________________________________________________________________

快速开始

# One-shot: analyze repo and apply all changes
npx -y agents-init@latest

# Preview what would be generated (no changes)
npx -y agents-init@latest --dry-run

______________________________________________________________________

Claude代码插件

将代理init安装为Claude Code插件，以便通过斜线命令轻松访问。

安装

# Add the marketplace
/plugin marketplace add Paldom/agents-init

# Install the plugin
/plugin install agents-init

用法

注： 插件命令的命名空间为 /agents-init:... （结肠分离器）。

替代方案：直接命令行界面

您也可以直接运行agents init而不使用插件：

npx -y agents-init@latest --dry-run  # Preview
npx -y agents-init@latest            # Apply

______________________________________________________________________

特性

基于标签的选择

该工具使用全面的标签分类法将您的项目与相关内容相匹配：

• 技能 -Claude代码技能包
• MCP服务器 -外部工具集成
• 子代理 -专业AI助手

所有选择都使用相同的标签重叠评分算法，确保一致性。

智能检测

自动检测：

• 语言（TypeScript、Python、Go、Rust等）
• 框架（Next.js、React、Vue、Django、FastAPI等）
• 数据库（PostgreSQL、MongoDB、Redis、Prisma、Drizzle等）
• 平台（Vercel、Cloudflare、AWS等）
• 测试框架（Jest、Vitest、Playwright、Cypress等）
• CI/CD管道（GitHub操作、GitLab CI等）

______________________________________________________________________

CLI使用情况

agents-init [root] [options]

选项

例子

# One-shot: analyze and apply all changes
npx -y agents-init@latest

# Preview changes (dry run)
npx -y agents-init@latest --dry-run

# CI/CD friendly (non-interactive)
npx -y agents-init@latest --no-interactive

# Only generate docs, skip skills and MCP
npx -y agents-init@latest --no-skills --no-mcp

# Use deterministic templates (no Claude CLI needed)
npx -y agents-init@latest --no-claude

# Verbose output
npx -y agents-init@latest --verbose

______________________________________________________________________

程序化API

import { agentsInit } from 'agents-init';

// One-shot: analyze and apply
const result = await agentsInit({
  root: '/path/to/repo',
  maxSkills: 5,
  maxMcp: 5,
  maxSubagents: 8,
});

console.log(result.tags);       // Detected tags
console.log(result.selections); // Selected skills, MCP, subagents
console.log(result.files);      // Generated file paths

// Preview only (no changes)
const preview = await agentsInit({
  root: '/path/to/repo',
  dryRun: true,
});

仅限分析

import { analyzeRepository } from 'agents-init';

const { profile, tags, selections, explanation } = await analyzeRepository(
  '/path/to/repo'
);

console.log(explanation); // Human-readable selection summary

______________________________________________________________________

创造什么

代理商.md

AI助手的全面指南，包括：

• 项目概况及技术栈
• 目录结构
• 开发指南
• 测试信息
• 常用命令
• 环境变量
• MCP服务器注意事项

CLAUDE.md

一个源于AGENTS.md的最小文件：

@AGENTS.md

.mcp.json

带有环境变量占位符的MCP服务器配置：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

.claude/commands/agents-init.md

用于重新生成配置的斜线命令：

/agents-init

注： 为了向后兼容性， .claude/commands/scaffold.md 也会生成一个已弃用的别名，转发到 /agents-init.

.claude/agents/\*.md

为您的堆栈提供专业的子代理，例如：

• frontend-developer.md
• backend-developer.md
• database-expert.md
• qa-engineer.md

______________________________________________________________________

标签分类

该工具使用全面的标签分类法，包括：

• 语言：JavaScript、TypeScript、Python、Go、Rust、Java等。
• 前端：React、Next.js、Vue、Nuxt、Svelte、Angular等。
• 后端：Express、Fastify、NestJS、Django、FastAPI等。
• 数据库：PostgreSQL、MySQL、MongoDB、Redis、Prisma、Drizzle等。
• 平台：Vercel、Cloudflare、AWS、GCP、Azure等。
• 开发运维：Docker、Kubernetes、Terraform、GitHub Actions等。
• 测试：杰斯特、维特、剧作家、赛普拉斯等。
• 角色前端开发人员、后端开发人员、DevOps工程师等。

看 src/tags.ts 查看完整列表。

______________________________________________________________________

技能和MCP

技能（来自Skills.sh）

agents-init 根据标签推荐技能，并可以选择安装它们。

npx skills add sickn33/antigravity-awesome-skills --skill "typescript-expert"

目录包括 201技能 从 反重力惊人的技能:

文件： 技能s.sh/docs

MCP服务器（来自MCP注册表）

agents-init 从官方注册表中推荐MCP服务器并将其写入 .mcp.json 带有env-var占位符的secrets。

• 注册表： register.modelcontextprotocol.io
• 克劳德代码MCP文档： code.claude.com/docs/en/mcp

次级试剂（来自VoltAgent）

子代理来源于 VoltAgent系列.

目录包括 115个子代理 跨越10个插件：

______________________________________________________________________

需求

• Node.js 18+（建议使用LTS版本）
• Git（用于存储库分析）
• 克劳德代码CLI （可选，用于增强发电）

兼容性

______________________________________________________________________

安全与隐私

读取哪些文件

• package.json, tsconfig.json，以及其他配置文件
• 用于语言检测的源文件（按扩展名）
• .gitignore 尊重被忽略的文件

哪些文件永远不会被读取

工具 自动排除 可能包含机密的文件：

• .env, .env.*, .envrc
• *.pem, *.key, id_rsa，SSH密钥
• credentials.json, service-account*.json
• *.tfstate, *.tfvars （地形状态）
• secrets.yaml, vault.yaml
• 数据库文件(*.sqlite, *.db)

供应链安全

• 所有GitHub操作都固定到完整提交SHA
• 使用发布的npm包 来源证明
• OpenSSF记分卡 已启用监控
• 最小运行时依赖关系（共9个）

______________________________________________________________________

发展

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/cli.js --dry-run

# Type check
npm run typecheck

# Run tests
npm test

# Lint
npm run lint

# Validate catalogs
npm run catalog:lint

______________________________________________________________________

发布过程

此项目使用 变更集 用于版本控制和发布。

对于贡献者

当进行应发布的更改时：

npm run changeset

这将创建一个描述更改的变更集文件。把它和你的公关联系起来。

自动发布

1. 变化集累积在 main
2. 自动创建/更新“发布”PR
3. 合并发布PR触发器：

- 版本升级 package.json - CHANGELOG.md 更新 - 使用npm发布 来源 - GitHub发布创建

发布安全

• 使用npm可信发布（OIDC）-没有长期令牌
• 来源证明将包链接到源代码提交
• 所有构建都可以从源代码复制

______________________________________________________________________

贡献

看 贡献.md 用于开发设置和指南。

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

链接

• AGENTS.md标准
• Claude代码文档
• MCP注册表
• 技能CLI
• VoltAgent子试剂