Tool Factory (tool-factory)

工具厂

Claude Code工具的自我修复生命周期系统。大规模构建、评分、翻新和管理技能、代理、钩子、命令和MCP服务器。

问题

Claude Code的工具生态系统发展迅速。经过数月的构建，你最终会得到数百个工具——技能、代理、钩子、命令、MCP服务器、插件——而且无法知道哪些工具有效，哪些是重复的，哪些是无用的。质量不一致。工具悄无声息地腐烂。

解决方案

工具厂将工具视为产品。生来就有标准，经过标准测试，漂移时翻新，过时时退役。制造机器并对其进行维护的机器。

建筑

两层，三个空间：

Layer 1: Factory (builds and maintains tools)
Layer 2: Tools  (the skills/agents/hooks that do actual work)

Factory Floor (generators/)  -- Creates new tools from templates
Range         (range/)       -- Scores tools against fitness criteria
Workshop      (workshop/)    -- Auto-retrofits failing tools

目录结构

tool-factory/
  generators/          # Tool creators (skill, agent, command, hook, MCP)
  range/               # Quality scoring (14 criteria, 100-point scale)
  workshop/            # Auto-retrofit for failing tools
  composer/            # Pipeline chaining (YAML compositions)
  registry/            # Tool inventory + intelligence + lifecycle
    index.json         # Single source of truth for all tools
    intelligence.sh    # Fleet health, usage, trends, dormant detection
    lifecycle.sh       # 4-phase maintenance cycle
    score-history.jsonl # Append-only score snapshots
    track-usage.sh     # Invocation logger
  lexicon/             # Constraint documents (best practices per vendor)
  scripts/             # Automation (scheduled lifecycle wrapper)
  lib/                 # Shared utilities (colors, etc.)
  validator/           # Structural validation
  VISION.md            # Where we're going (north star)
  SPEC.md              # What exists today (living spec)
  BUILDING.md          # How we got here (build log)

快速开始

创建工具

# Generate a new skill with frontmatter, test fixtures, and registry entry
bash generators/skill.sh my-new-skill

# Generate other tool types
bash generators/agent.sh my-agent
bash generators/command.sh my-command
bash generators/hook.sh my-hook
bash generators/mcp.sh my-mcp-server

为你的工具打分

# Score a single tool
bash range/runner.sh my-skill

# Score all tools (fleet-wide)
bash range/runner.sh --all

# Report mode (no changes)
bash range/runner.sh --report

评分以100分制对3个类别的14个标准进行评估。结果：通过（70+），部分通过（40-69），未通过（\ retrofit -> dormant check -> decay alerts bash registry/lifecycle.sh

Report mode (dry run, no changes)

bash registry/lifecycle.sh --report

Individual phases

bash registry/lifecycle.sh --score bash registry/lifecycle.sh --fix bash registry/lifecycle.sh --flag-dormant

### 组合管道

Create a new pipeline

bash composer/compose.sh new my-pipeline

List all pipelines

bash composer/compose.sh list

Validate a pipeline

bash composer/compose.sh validate my-pipeline

Run a pipeline

bash composer/compose.sh run my-pipeline

组合是将工具链接到顺序工作流中的YAML文件：

name: deploy-pipeline description: Score, fix, and report steps: - type: shell name: preflight command: "echo 'Starting...'"

- type: shell name: get-version command: "cat package.json | jq -r .version" export_as: VERSION

- type: shell name: test command: "npm test" on_fail: fallback-lint

- type: shell name: deploy command: "echo Deploying v$VERSION"

- type: shell name: fallback-lint command: "npm run lint" skip: true

特点：环境变量注射(`export_as`)，条件分支(`on_fail`)，只跳几步(`skip: true`)，以及 `continue_on_fail` 对于非关键步骤。

### 计划自动维护（macOS）

计划的生命周期每天通过launchd运行——工作日的模拟运行报告，周日的实时修复：

Test the wrapper manually

bash scripts/scheduled-lifecycle.sh

Force a live run (regardless of day)

bash scripts/scheduled-lifecycle.sh --force

看 `scripts/` 用于启动plist模板。

## 三合会

工具厂使用三文档系统而不是PRD：

- **视觉.md** --我们要去哪里。七个支柱，每个支柱都有一个实现百分比。
- **规格.md** --今天存在什么。能力、架构、验证界面。
- **建筑.md** --我们是如何到达这里的。建立包含决策和理由的日志。

VISION和SPEC之间的差异就是路线图。任何两个文件都可以重建第三个文件。

## 需求

- macOS或Linux
- Bash 3.2+
- Python 3.6+
- Claude Code（用于工具本身）

## 许可证

麻省理工学院——见 [许可证](LICENSE).

## 作者

建造于 [id8Labs](https://id8labs.app) 作为Claude Code工具生态系统的一部分。