克劳德锻造厂

一组TypeScript代理和实用程序，用于通过自定义配置、MCP集成和专用工作流增强Claude Code CLI功能。

起源

先决条件

安装Bun

该项目需要包子，一个快速的一体化JavaScript运行时。使用以下方式安装：

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Windows (via PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

# Or via npm/yarn if you have Node.js
npm install -g bun

安装Claude CLI

确保已安装Claude CLI：

npm install -g @anthropic-ai/claude-code

快速开始

克隆存储库：

git clone https://github.com/ag0os/claude-forge.git
cd claude-forge

安装依赖项：

bun install

构建所有代理：

bun run watch  # Watches and auto-compiles all agents
# OR
bun compile agents/designer.ts  # Compile a specific agent

将代理设置为全局命令

这个项目将TypeScript代理编译成可以用作全局命令的独立二进制文件。以下是如何设置 designer agent（或任何其他agent）作为全局命令：

方法1：使用 `bun watch` （建议开发）

这 bun watch 命令自动编译中的所有代理 agents/ 目录并监视更改：

# Start the watcher (compiles all agents and watches for changes)
bun run watch

这将：

编译所有TypeScript文件 agents/ 到二进制文件 bin/
关注变化 agents/ 和 prompts/ 目录
文件更改时自动重新编译
删除源文件时删除二进制文件

方法2：手工编译

根据需要编制个人代理：

# Compile a specific agent
bun compile agents/designer.ts

# The binary will be created at ./bin/designer

在全球范围内提供代理

编译后，添加 bin 将代理用作全局命令：

# Add to your shell profile (~/.bashrc, ~/.zshrc, ~/.bash_profile, etc.)
export PATH="$PATH:/path/to/claude-forge/bin"

# Reload your shell configuration
source ~/.zshrc  # or ~/.bashrc, depending on your shell

# Now you can use agents as commands from anywhere
designer "Create a responsive landing page"
contain "Analyze this codebase"
planner "Help me plan a new feature"

设计师代理的工作原理

设计器代理是一个专门的Claude CLI启动器，它：

加载自定义配置： 从以下位置读取设置 settings/designer.settings.json 和MCP配置 settings/designer.mcp.json
应用系统提示： 包括一个以设计为中心的系统提示 system-prompts/designer-prompt.md
启用MCP工具： 与Figma和Chrome DevTools集成，用于设计工作流程
传递论点： 你提供的任何论点都会传递给克劳德

示例用法：

# After adding bin/ to PATH
designer "Create a card component with hover effects"

# Or run directly from the project
./bin/designer "Help me design a navigation menu"

# Or use bun to run the TypeScript directly
bun run agents/designer.ts "Design a color palette for a tech startup"

项目结构

agents/ -生成具有自定义配置的Claude CLI的TypeScript代理
bin/ -编译的独立二进制文件（由build/watch生成）
settings/ -代理的JSON配置文件
system-prompts/ -专门行为的系统提示
prompts/ -Markdown提示模板
hooks/ -响应Claude事件运行的脚本
lib/ -Claude CLI交互的核心实用程序
scripts/ -建造和开发公用设施

可用代理

每个代理都是一个具有自定义配置的专用Claude实例：

任务特定代理

设计师 -使用Figma/Chrome DevTools集成的设计模式
建造者 -根据商定的计划进行交互式建筑工作流程
规划器 -战略规划模式（生成计划，不执行）
重构 -保持外部行为的内部结构改进
包含 -具有回购范围设置/MCP的隔离环境
即兴重复段 -通过伪代码对话进行设计探索（语言无关）

协调代理

管弦乐队 -使用管道和循环进行代理编排（请参阅下面的Orchestra部分）
链条 -链接多个Claude实例（planner→ 包含）
平行 -同时运行并行操作
铁路积压 -Rails待办事项任务协调员（分析Backlog.md+协调子代理）
计划协调员 -实施计划协调员（逐步协调子代理）
伪造任务管理器 -将计划/要求摘要到带有标签的锻造任务中
锻造任务协调员 -协调子代理执行伪造任务
锻造任务工 -处理单个锻造任务，更新验收标准

分析和研究代理

定向 -为概念、特征或文件生成方向图
头脑风暴 -根据你的想法生成5个AI代理变体，并选择一个
设计审计 -综合设计体系/现场造型审核
github示例 -在GitHub上搜索真实世界的示例和模式
期望 -推出克劳德与质量期望系统提示

图表代理

图表全部 -项目范围内详尽的事件流图生成器
图表主题 -生成仅限于单个主题的图表
图表合并 -按主题验证、消除重复和捆绑图表

推理代理（双子座驱动）

推断 -从对话历史推断命令或钩子（支持模式：命令、钩子）
推断命令 -从最新对话中提取命令
宝石 -双子座动力总结
克劳德视频 -Gemini驱动的视频分析和指令提取

实用代理

更新claudemd -按照最佳实践维护和更新CLAUDE.md文件
克劳德混音 -以Repomix为重点的包装回购流程
快速改良剂 -将提示转换为三种结构化的Markdown变体
脚本工具包生成器 -根据想法生成脚本工具包脚本

开发人员实用程序

最新的 -查找并查看最新对话
搜索 -搜索对话历史记录
列出mcp工具 -列出MCP端点可用的工具
打印键 -打印GEMINI_API_KEY（辅助工具）
jsonl格式化程序 -JSONL解析工具和jq配方

Forge任务：混合任务管理

一个基于文件的任务管理系统，将CLI命令与可编程的子代理相结合，以实现协调的工作流程。任务通过YAML frontmatter存储为人类可读的markdown文件。

主要特点

基于文件的存储：任务是中的markdown文件 forge/tasks/，易于手动编辑或提交到git
完整的CLI界面：从命令行创建、列出、查看、编辑、删除和搜索任务
程序化API：TypeScript TaskManager 用于构建自定义工作流的类
分代理：专业 forge-task-manager 和 forge-task-worker 自动化任务工作流的代理
多种输出格式：人类可读、纯文本（用于脚本）和JSON

快速示例

# Initialize forge-tasks in your project
forge-tasks init

# Create a task with acceptance criteria
forge-tasks create "Implement user auth" \
  --description "Add JWT-based authentication" \
  --priority high \
  --ac "Login returns JWT token" \
  --ac "Protected routes require valid token"

# List tasks, filter by status
forge-tasks list --status todo --priority high

# View task details (use --plain for scripts/agents)
forge-tasks view TASK-001

# Update status and check off acceptance criteria
forge-tasks edit TASK-001 --status in-progress --check-ac 1

有关包括程序使用和子代理集成在内的完整文档，请参阅 docs/FORGE-TASKS.md.

管弦乐队：代理编排

Orchestra使用两种执行模式编排代理链：管道（每个运行一次）和循环（重复直到完成标记或最大迭代次数）。

快速示例

# Single agent loop - run up to 10 iterations
orchestra task-coordinator:10

# Pipeline - run agents once each, in sequence
orchestra "task-manager -> task-coordinator"

# Chain with iterations
orchestra "task-manager:3 -> task-coordinator:10"

# Config mode - named chains from forge/chains.json
orchestra --chain plan-and-build
orchestra --chain single-task TASK_ID=TASK-001

# With prompts - pass instructions to agents
orchestra task-coordinator:10 -p "Focus on authentication tasks"
orchestra --chain build --prompt-file prompts/instructions.md

DSL语法

模式	行为
`agent`	运行一次，不进行完成检查
`agent:N`	循环N次，停止 `ORCHESTRA_COMPLETE`
`a -> b`	管道：运行a然后b（两者都运行一次）
`a:3 -> b:10`	链：a循环到3，然后b循环到10

配置（forge/chains.json）

{
  "agents": {
    "task-manager": { "defaultPrompt": "Create tasks from requirements" }
  },
  "chains": {
    "plan-and-build": {
      "description": "Plan then implement",
      "prompt": "Focus on ${FEATURE_NAME}",
      "steps": [
        { "agent": "task-manager" },
        { "agent": "task-coordinator", "iterations": 10 }
      ]
    }
  }
}

有关包括提示分辨率和完成标记在内的完整文档，请参阅 docs/ORCHESTRA.md.

______________________________________________________________________

图表代理

运行项目范围的图表：

- bun run agents/diagram-all.ts [optional focus words]

运行以主题为中心的图表：

- bun run agents/diagram-topic.ts [extra focus]

整合现有图表：

- bun run agents/diagram-consolidate.ts [optional filters]

开发命令

# Watch and auto-compile all agents
bun run watch

# Compile a specific agent
bun compile agents/[agent-name].ts

# Format and lint code
bun run lint

# Run type checking
bun run check

# Run the main entry point
bun run index.ts

创建自己的代理

在中创建一个新的TypeScript文件 agents/:

// agents/my-agent.ts
import { spawn } from "bun";

const child = spawn(["claude", "--model", "claude-3-opus", ...args], {
    stdin: "inherit",
    stdout: "inherit",
    stderr: "inherit",
});

await child.exited;

创建相应的设置文件（可选）：

settings/my-agent.settings.json -克劳德设置
settings/my-agent.mcp.json -MCP工具配置

编译您的代理：

bun compile agents/my-agent.ts
# Creates ./bin/my-agent

使用您的代理：

./bin/my-agent "Your prompt here"

提示

监视脚本监视这两个 agents/ 和 prompts/ 目录
对提示的更改会触发完全重建，因为它们是在编译时导入的
二进制文件是自包含的，包括所有依赖项
每个代理都可以有自己的MCP工具、设置和系统提示
使用环境变量，如 CLAUDE_PROJECT_DIR 将上下文传递给代理

此项目是使用创建的 bun init 在bun v1.2.9中。

东方代理

生成一个方向图，跟踪围绕概念或文件的文件、依赖关系、依赖项、函数、事件流提示和测试。

用途：

# Analyze a concept/keyword
bun run agents/orient.ts "authentication"

# Analyze a specific file
bun run agents/orient.ts src/utils/loader.ts

# Options
bun run agents/orient.ts router --out-dir ./orientations --max-files 0 --ext ts,tsx,js,jsx,json,md --debug

输出：

在中创建markdown文件 ./orientations/ 命名为like authentication-YYYYMMDD-HHMMSS.md.
章节包括：概述、文件引用、依赖关系/依赖项（如果是文件目标）、主题附近的函数、事件流提示、涉及主题的测试和下一步。

代理和提示：行为和使用场景

这个仓库提供了多个专注的代理，这些代理与结构良好的提示相连接。提示遵循一致的最佳实践，以提高可靠性和解析能力。

常见的即时期望

私人草稿：代理人私下一步一步地思考；输出仅包含结果和基本原理（没有思想链）。
结构化输出：代理每回合都会发出类似XML的标记块（例如。， `, , , , )或域块，如 ,

, , , `.

代码围栏：标有语言和文件名注释；变化很小，而且是可逆的。
工具安全：编辑前阅读；避免破坏性命令；永远不要泄露秘密。
决策循环：许多提示显示了3个选项和块 1/2/3 选择或最小的修改。

何时使用哪个代理

designer （系统提示/设计器提示.md）

- 令牌优先设计系统工作（颜色/排版→ 原子→ 生物体→ 页面）。 - 生产 `` 具有3个选项的块，Storybook/Chrome DevTools MCP验证和可访问性门。 - 在建立或发展具有视觉验证的设计系统时使用。

builder （系统提示/builder提示.md）

- 根据每个功能，从降价计划迭代实现 `` 有计划/预览/验证/提交。 - 用户通过继续/修改/跳过来控制进度；跟踪状态和测试。 - 用于根据商定的计划进行增量、可审查的交付。

refactor （系统提示/重构prompt.md；提示/重构提示.md）

- 保持外部行为的内部结构改进；基线优先，可逆的小步骤。 - `` 具有选项、奇偶校验、提交消息、流失限制。 - 用于在不改变行为的情况下偿还科技债务。

feature （系统提示/功能提示.md）

- 将指定的功能转化为具有可验证验收标准的可交付代码。 - 每一步3个选项； `` 包括实施前的验证计划。 - 用于叙述或用户故事中的新功能。

fix （系统提示/修复提示.md）

- 在补丁之前进行强制失败测试的漏洞修复； `` 格式。 - 用于可靠的、测试优先的护栏错误修复。

performance-tuner （系统提示/performance-tuner.md）

- 设定目标，捕捉基线，然后使用测量计划进行最小的安全优化。 - 用于再现性重要的表演工作。

planner （系统提示/计划生成器.md）

- 仅提出计划；不实现代码。生产具有选项和特定于提交/文件的计划。 - 在开始工作之前，使用它来达成一个可操作的计划；可以用链子锁住。

orient （系统提示/定向提示.md）

- 方向分析 `` 输出：概述、结构、技术、命令、工作流程、最近、下一个。 - 在加入仓库或确定变更区域范围时使用。

update-claudemd （系统提示/更新claudemd提示.md）

- 维护CLAUDE.md；发射 `` 带有摘要/差异/更新文件/验证。 - 用于为Claude Code创建或刷新项目内存。

brainstorm （系统提示/头脑风暴提示.md）

- 生成5个不同的代理想法；和 `` 以及一项建议。 - 用于在决定采用某种方法之前进行构思。

github-examples （提示/github示例.md）

- 在GitHub上搜索真实世界的示例并撰写 ai/github-examples/.md. - 发射 `` 带有示例、比较和路径的块。 - 用于发现模式、验证方法或收集灵感。

claude-mix （提示/claude mix.md）

- 以Repomix为重点的流程，用于打包回购和生成分析；保存/解析时的结构化输出。 - 用于为下游LLM生成紧凑的存储库表示。

claude-video / gemsum

- Gemini驱动的视频分析和摘要； claude-video 可以将提取的指令传递给Claude。 - 需要 GEMINI_API_KEY；在下面写入输出 ai/claude-video 或 ai/gemsum. - 用于从.mp4内容中提取全面的说明或摘要。

jsonl-formatter(.ts/.tsx)

- 在JSONL打印模式下运行Claude，并演示jq配方以提取见解。 - 用于学习/自动化成本、工具、模型、内容和时间线的JSONL解析。

parallel

- 将任务拆分为独立的子任务，并通过Claude同时运行它们。 - 用于并行化分离良好的工作项；注意模型成本。

chain

- 跑 planner 生成计划，然后启动 contain 预先加载了该计划。 - 用于从规划中转移→ 在一个命令中约束执行。

contain

- 使用仓库范围的设置/MCP（容器样式环境）启动Claude；一致、可重复的上下文。 - 用于跨机器或团队的“标准化”会话。

riff （系统提示/rif-premp.md）

- 通过伪代码对话进行设计探索；基于卡斯珀·蒂姆·汉森的“膛线”技术。 - 检测技术栈，通过伪代码探索问题，展示设计决策和开放式问题。 - 用于承诺实施之前的早期设计探索。

rails-backlog （系统提示/rails积压协调器提示.md）

- Rails积压任务协调员；从backlog.md读取任务并协调专门的子代理。 - 处理任务分析、子代理协调、生命周期管理和完成定义验证。 - 用于具有积压驱动开发工作流的Rails项目。

plan-coordinator （系统提示/计划协调员提示.md）

- 实施计划协调员；制定计划并协调子代理执行每个步骤。 - 处理计划解析、进度跟踪和步骤之间的质量验证。 - 用于与协调的子代理一起执行多步骤计划。

infer

- 双子座通过对话历史进行推理；支持 --mode commands 或 --mode hooks. - 将用户指令提取为斜线命令或识别钩子自动化机会。 - 用于从过去的对话中生成可重用的命令/钩子。

design-audit （系统提示/设计审核提示.md）

- 全面的设计体系/现场造型审核；扫描标记、变量、主题、布局、模式。 - 将可导航的审计报告写入 ai/design-audit/ 无需修改应用程序代码。 - 用于理解和记录现有的设计系统。

prompt-improver （系统提示/提示改进程序prompt.md）

- 将提供的提示/规范转化为三种结构化的Markdown变体，并带有获胜者的理由。 - 用于在使用前迭代和改进提示。

script-kit-gen

- 根据想法生成脚本工具包脚本；写信给 ~/.kenv/scripts/. - 用于快速为Script Kit创建自动化脚本。

expectations （提示/期望.md）

- 推出克劳德与质量期望系统提示。 - 用于在Claude会话中执行质量标准。

list-mcp-tools

- 列出通过HTTP POST或CLI从MCP端点可用的工具。 - 支持经过身份验证的端点 --token 旗帜。 - 用于从MCP服务器中查找可用工具。

对话实用程序： latest, search, conv

- 将当前仓库映射到 ~/.claude/projects 并检查/导出JSONL对话。 - 用于快速查找和导出过去的会话或生成成绩单。

凭证和工具

Gemini功能需要 GEMINI_API_KEY 在环境中。
一些代理通过1Password CLI获取机密(op)--确保您已登录。
GitHub MCP的使用需要有效的令牌（请参阅agents/GitHub-examples.ts注释）。

运行时一致性

所有CLI代理都使用Bun-shebang和处理SIGINT/SIGTERM来干净地停止子进程。
提示强制执行结构化输出、相关的三个选项决策循环和非破坏性工具使用。

Claude Forge

快速接入

详细介绍

克劳德锻造厂

起源

先决条件

安装Bun

安装Claude CLI

快速开始

将代理设置为全局命令

方法1：使用 bun watch （建议开发）

方法2：手工编译

在全球范围内提供代理

设计师代理的工作原理

项目结构

可用代理

任务特定代理

协调代理

分析和研究代理

图表代理

推理代理（双子座驱动）

实用代理

开发人员实用程序

Forge任务：混合任务管理

主要特点

快速示例

管弦乐队：代理编排

快速示例

DSL语法

配置（forge/chains.json）

图表代理

开发命令

创建自己的代理

提示

东方代理

代理和提示：行为和使用场景

常见的即时期望

何时使用哪个代理

凭证和工具

运行时一致性

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

方法1：使用 `bun watch` （建议开发）