AgentSmith
为编码代理配置项目规则与可验证的完成标准，让每次改动都有证据。
- Star 数
- ★ 152
- 最近更新
- 13 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 75/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在多个仓库中为 Claude Code 或 Codex 统一项目规则和完成标准的开发者。
- 不适合
- 需要 AgentSmith 自动选择或生成应用框架的团队
- 需要安装时直接执行项目代码的团队
- 源码审查
- 75/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
AgentSmith 是一个面向 Claude Code、Codex 等编码代理的开源命令行工具，用于把项目规则和工作类型配置带入仓库。它通过引导式向导检查现有项目或初始化空文件夹，并在写入前展示安装计划。安装内容包括作为规范的 AGENTS.md、Claude Code 使用的生成式 CLAUDE.md、定义项目检查项的 .harness/verify.conf，以及记录 AgentSmith 自有设置的 .agentsmith/state.json。代理按所选工作配置完成有界任务、运行已配置检查并保留验证证据；用户可在项目中记录决策和交接。独立构建适用于 macOS、Windows 和 Linux，内含运行时，不要求 Python。
运行 agentsmith 启动向导后，用户可选择配置现有项目或创建空文件夹并初始化 Git。向导检查文件证据并推荐工作配置，展示将写入的文件计划，再生成项目规则和验证脚手架；现有项目检查时不会运行项目代码，也不会替换既有项目配置。软件开发配置将构建、检查、测试、安全审查和真实调用列为主要证明；其他配置覆盖运维、营销、文档、数据、行政、研究、设计和安全审计。可选高级设置提供技能、MCP 服务器和钩子；agentsmith memory search 与 agentsmith memory read 可搜索或读取本地笔记，agentsmith audit-config 可生成只读配置建议报告。
- 希望在多个仓库中为 Claude Code 或 Codex 统一项目规则和完成标准的开发者。
- 需要先检查现有项目、查看配置计划，再添加验证脚手架的团队。
- 希望为功能、修复或重构定义构建、测试、安全审查和真实调用证据的工程团队。
- 需要让代理保存决策与交接，便于在后续会话继续工作的维护者。
- 需要按运维、文档、研究、设计等任务类型配置完成标准的跨职能团队。
如何安装或部署这个 Agent？
从最新发布页下载适用于 macOS、Windows 或 Linux 的独立构建。macOS 和 Windows 构建目前未签名，系统可能要求确认后才能运行。构建内含运行时，无需安装 Python。启动命令：
agentsmith也可让 Claude Code、Codex 或其他编码代理按官方安装指南操作；代理应先检查仓库、解释配置建议并展示计划，然后再应用安装。高级用户和贡献者可参阅 INSTALL.md 的源码构建说明。
如何使用这个 Agent？
启动 agentsmith 并回答引导问题。为现有项目选择配置，或指定空文件夹以创建新项目；向导会在写入前展示准确计划。完成后，代理使用 AGENTS.md 中的规范和 .harness/verify.conf 中的检查项工作。可选地使用本地记忆命令：
agentsmith memory search "topic"
agentsmith memory read docs/research/note.md运行只读配置审计：
agentsmith audit-config--include-user 可加入原生用户设置，--fail-on high 可增加 CI 门槛。
这个 Agent 有哪些优点和局限？
- 同一份 AGENTS.md 作为规范，并为 Claude Code 生成导入它的 CLAUDE.md，避免规则分叉。
- 向导在写入前展示计划，并根据项目文件证据推荐工作配置。
- 通过 .harness/verify.conf 指定项目检查，且示例证据包展示失败测试、修复后验证、真实命令调用、收据和交接。
- 记录 AgentSmith 自有设置，以便更新或移除时保留外部内容。
- 可选配置覆盖软件开发之外的运维、文档、研究、设计等工作类型。
- 独立版在 macOS 和 Windows 上未签名，运行时可能需要用户确认。
- 新项目流程只创建或验证空目录并初始化 Git，不会选择或生成应用框架。
- 检查现有项目时不会执行项目代码；首次验证需要之后实际运行已配置的检查。
- 高级技能、MCP 服务器和钩子的具体效果需在安装前单独查看。
这个 Agent 与同类方案有什么区别？
README 将 AgentSmith 描述为从随意编程转向有证据的代理工程的工具，但没有提供与其他产品的直接功能比较。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AgentSmith 当前 | 75 · 表现良好 | 命令行工具免费 | ★ 152 | 13 天前 | Python | Codex · Claude Code |
| Spec Kit | 72 · 存在缺口 | 命令行工具 | ★ 149k | 1 天前 | Python | — |
| Keep the Why | 83 · 表现良好 | Agent 插件 / 技能免费 | ★ 235 | 2 天前 | JavaScript | Codex · Claude Code |
| Swarm Orchestrator | 73 · 存在缺口 | — | ★ 114 | 2 天前 | TypeScript | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
谨慎权限模式、明确的外部写入同意规则、更新计划与回滚收据、秘密扫描和脱敏说明，都支持较强的日常防护。自主运行另有已接受规格、明确授权和本地沙箱门槛；不过提供的内容主要是规则与文档声明，未包含核心安装器实现，数据流和依赖来源的可审计细节有限，因此未给满分。
文档描述多平台检查、故障封闭行为及具体错误情形，工作图安全审查也指出已知间歇性故障仍开放。当前材料中的 AGENTS.md 要求一次错误后自行研究并继续，但自主运行技能设置了明确授权门槛，且有关“无外部写入”的范围较窄；这些规则的优先关系和适用范围没有完全统一说明，因此自洽性偏低。未执行任何运行或测试。
多个工作配置覆盖开发、运维、研究、管理、创意和安全等任务，并区分普通工作与有限自主运行；文档还说明容器限制及不同客户端的配置差异。技能触发描述通常具体，但样本只有部分技能，且部分边界依赖客户端实现和宿主沙箱，因此精确度与环境适配未满分。
仓库提供分层文档、安装指南、故障排查、更新记录、已知限制、安全政策及 MIT 许可证。安装流程先展示计划并要求确认，更新有回滚收据；但本材料未展示主要安装源码，也未提供完整版本历史或明确个人维护责任，故安装和维护相关评分有所扣减。
核心规则要求把完成标准转成检查和证据，交接技能规定了可直接用于新会话的恢复材料，示例技能和演示测试展示了用户可见结果。对需要可验证交付的工作有明显价值；不过增加配置、检查和记录也带来持续成本，效果证据在本次静态材料中主要来自文档自述，未执行评估。
若干主张链接到具体文档、检查名称、测试文件和已知问题；配置审计文档也区分静态模式检查与实际执行证据。工作图审查说明跨平台报告的提交和树匹配条件，同时承认遥测声明不是独立观测。不过证据主要由同一仓库提供，当前修订与部分历史报告的对应关系不能仅凭所给材料完整确认，且不少结果仍是维护者陈述。
- 本评估仅依据用户提供的静态样本，未检查完整仓库或执行程序、安装器和测试。
- 自主运行需确认接受的规格、实施工单、操作授权及沙箱可用；文档指出协作式资源锁不能替代操作系统隔离。
- 材料记录了 macOS 清理预览和 Windows 子控制器等间歇性问题仍未解决；未签名的 macOS 和 Windows 构建可能触发系统确认提示。
你是这个项目的维护者？把 FARS 徽章加到 README
[](https://followagents.com/zh/agents/agentsmith)<a href="https://followagents.com/zh/agents/agentsmith"><img src="https://followagents.com/badge/agentsmith.svg?lang=zh" alt="FARS 评测"></a>最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.5.0 AgentSmith 0.5.0
发布说明摘录
AgentSmith 0.5.0 makes the always-loaded rules about 40% shorter and closes the installer-safety issue #50. It also adds checks that show whether your rules actually take effect, and guards for unattended runs. Highlights - Leaner rules. The core and the software-dev profile drop from about 5,800 to about 3,350 words. Generic coding advice that current models follow unprompted is gone. Consent, secrets, identity, authority and the trust gates stay. The static-context budget is now 480 lines / ~7,800 tokens (#64). …在 GitHub 查看 ↗ -
v0.4.0 AgentSmith 0.4.0
发布说明摘录
What's Changed * feat: make AgentSmith setup beginner-ready by @PromptPartner in https://github.com/PromptPartner/agentsmith/pull/39 * Explain AgentSmith through guardrails and proof in all five README languages by @PromptPartner in https://github.com/PromptPartner/agentsmith/pull/40 * Harden autonomous recovery and add offline qualification evidence by @PromptPartner in https://github.com/PromptPartner/agentsmith/pull/41 * Add optional local memory, hook disclosures and configuration audit by @PromptPartner in https://github.com/PromptPartner/agentsmith/pull/42 …在 GitHub 查看 ↗ -
v0.3.1 AgentSmith 0.3.1
发布说明摘录
AgentSmith 0.3.1 adds safe, evidence-backed integration validation and hardens durable recovery. Highlights - A conditional MCP/integration checkpoint records discovery versus exact pins; configured, authenticated, read-tested, and least-privilege states; auto-start, capability listing, and actual invocation; named consumers and credential classes; response minimization; persistent state; shared-store causality; and exact child-process cleanup. …在 GitHub 查看 ↗
常见问题
使用 AgentSmith 需要付费吗？
AgentSmith 会在安装时运行我的项目吗？
它会覆盖已有项目配置吗？
AgentSmith 能替我构建新应用吗？
可以无人值守地运行代理吗？
谢谢反馈，我们会据此改进页面。