Lixiuxiu559/AgentForge

通用 agent 工作流与工程技能集,同时作为 Claude Code 插件与 DeepSeek Harness 插件分发。实施编排 + 三轴 diff 评审 + 复杂度审计 + 突变测试,零外部依赖。

Project Overview项目介绍

AgentForge is a general-purpose agent workflow and engineering skill set distributed as an installable plugin for both Claude Code and DeepSeek Harness. The repository is explicitly designed around a zero-external-dependency contract: it does not use MCP servers, does not call the network at runtime, and does not require any project-installed tooling, so every capability ships inside the bundle itself. The package delivers six skills — research, architecture-scout, diff-review, implementation-workflow, complexity-audit, and mutation-testing — together with five sub-agents (researcher, diff-reviewer, implementer, complexity-auditor, mutation-auditor). Skills and agents live once on disk; Claude Code discovers them natively through skills/<name>/SKILL.md and agents/<name>.md, while DeepSeek Harness mounts a zero-dependency bridge plugin in src/index.js that re-registers the same assets as a skill provider and as a single agentforge tool whose agent enum enumerates every role.

Installation follows each host's native command surface. On Claude Code, users run claude plugin marketplace add Lixiuxiu559/AgentForge followed by claude plugin install agentforge@agentforge, then restart Claude Code to activate; a local-path variant allows in-place development loading. On DeepSeek Harness, the recommended path is dsh plugin --profile web add dsh-agentforge, because dsh plugin is a pnpm forwarder that resolves the dependency, inspects the declared dsh.bundle field in package.json, and appends the bundle into dsh.profile.bundles. GitHub shorthand, tag-pinned, and local-directory installs are also documented, with explicit warnings that git installs have no version gating — lockfile commits move with every push to main, so npm is the only release-gated channel. Typical users are engineers who want repeatable review, complexity, mutation, and implementation workflows inside either CLI.

Dependencies and limits are minimal but strict. The only hand-written code is the zero-dependency bridge in src/index.js, there is no prepare script, so DSH never needs allowBuilds. Tool-name drift between hosts (Claude Code's Read versus DSH's read) is reconciled by the bridge, and unmapped names are dropped with a warning. maxTurns is deliberately omitted because DSH lacks an equivalent and silent truncation would fabricate false negatives on read-only audits. The bridge tool cannot reuse reserved DSH names such as subagent, otherwise plugin loading fails; a cordis.patch.yml line can rename it via config.toolName. License is MIT; node tools/doctor.mjs performs dual-host validation including DSH-specific checks, and the profile must be restarted after install because patchReload: live only watches user patch files and does not re-run apply().

AgentForge 是一套通用 agent 工作流与工程技能集,同时作为可安装的 Claude Code 插件与 DeepSeek Harness 插件发布。仓库坚持零外部依赖原则:不使用 MCP,不依赖网络,也不要求项目预装工具,所有能力来自 6 个技能(research、architecture-scout、diff-review、implementation-workflow、complexity-audit、mutation-testing)与 5 个子 agent。技能与子 agent 在磁盘上仅有一份真源,Claude Code 通过原生自动发现加载,DeepSeek Harness 则通过 src/index.js 桥接插件把这套资产注册为 skill provider 与单一 agentforge 工具,工具描述里枚举全部 agent。

安装上两端各自走原生命令:Claude Code 用 claude plugin marketplace add Lixiuxiu559/AgentForge 与 claude plugin install agentforge@agentforge,装后需重启生效;DeepSeek Harness 推荐用 dsh plugin --profile web add dsh-agentforge,由 dsh plugin 作为 pnpm 转发器读取 package.json 中的 dsh.bundle 声明并写入 profile。也支持 GitHub 简写、tag 钉版与本地目录开发装,升级用 dsh plugin update,卸载用 dsh plugin remove。典型用户是用 Claude Code 或 DSH 做代码评审、复杂度审计、突变测试与实施编排的工程师,使用时通过 / 命令面板调用技能或在模型里选中 agentforge 工具枚举 agent。

依赖与限制方面,src/index.js 是唯一的零依赖桥接代码,仓库不含 prepare 脚本,因此 DSH 侧任何装法都无需 allowBuilds 构建授权。工具名差异(Read 对 read)由桥接层映射,未映射名字会丢弃并记录 warning;maxTurns 刻意不启用,因为 DSH 无对应物且超限截断会让只读审计出现假阴性;DSH 侧工具名需避开 subagent 等保留名,否则插件装载直接失败。许可证为 MIT,node tools/doctor.mjs 可做双端适配校验,首装后必须重启 profile 才能让插件进入 apply() 阶段。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:Lixiuxiu559/AgentForge

把 Lixiuxiu559/AgentForge 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

AgentForge

通用 agent 工作流与工程技能集,可安装到 Codex、Claude Code 与 DeepSeek Harness。 包内 JavaScript 零 dependencies,无必需 MCP 服务;审计复用项目已有工具,独立上下文和并行依赖宿主的通用子 agent 能力。

validate

一份真源,三端共用:七个技能统一维护在 skills/。 Codex 与 Claude Code 加载技能目录,DSH 使用包内桥接插件(src/index.js)。


安装

Codex

在仓库本地验证:

codex plugin marketplace add /path/to/AgentForge
codex plugin add agentforge@agentforge

插件发布到仓库默认分支后,也可从 GitHub 安装:

codex plugin marketplace add Lixiuxiu559/AgentForge
codex plugin add agentforge@agentforge

Codex 桌面端可在 Plugins Directory 选择 AgentForge 安装;安装后开启新任务验证技能。仓库的 .agents/plugins/marketplace.json 指向根目录插件,.codex-plugin/plugin.json 声明七个技能。architecture-scout 在 Codex 侧也只接受主动调用,其技能目录内的 agents/openai.yaml 是调用策略元数据,不是自定义子 agent。

Claude Code

claude plugin marketplace add Lixiuxiu559/AgentForge
claude plugin install agentforge@agentforge

在 Claude Code 交互界面里对应:

/plugin marketplace add Lixiuxiu559/AgentForge
/plugin install agentforge@agentforge

安装后重启 Claude Code 使其生效。

本地开发时可以装本地目录(原位加载,改动立即生效,不受版本号约束):

claude plugin marketplace add /path/to/AgentForge
claude plugin install agentforge@agentforge

其他常用命令:

claude plugin list                            # 已装插件
claude plugin details agentforge              # 组件清单与 token 成本
claude plugin update agentforge@agentforge    # 更新到新版本
claude plugin disable agentforge              # 临时停用
claude plugin uninstall agentforge            # 卸载

DeepSeek Harness

dsh plugin --profile web add github:Lixiuxiu559/AgentForge

dsh plugin 是 pnpm 的转发器:它在 profile 目录($DSH_HOME/profiles/<name>)里执行 pnpm <你的参数>,然后读回 profile 的 package.json —— 凡是解析到声明了 dsh.bundle 的依赖,就自动追加进 dsh.profile.bundles 层栈(本仓库已声明,见 package.json)。 所以参数可以是 pnpm 接受的任何 spec:

装法 命令 升级语义
GitHub 简写 dsh plugin --profile web add github:Lixiuxiu559/AgentForge 钉 commit,update 会跟到 main 最新提交
钉 tag dsh plugin --profile web add github:Lixiuxiu559/AgentForge#v0.4.2 钉该 tag 的 commit,不受分支变动影响
本地目录(开发用) dsh plugin --profile web add /path/to/AgentForge 直接读磁盘,改动立即生效

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-plugin-vet 下一个 Next dsh-plugin-no-workspace →