前言¶
在构建智能体应用时，维护一套统一的工作流标准、测试设计规范和代码评审流程往往需要重复造轮子。AgentForge 提供了一套经过整合的 agent 工作流与工程技能集，旨在解决这些问题。
简介¶
这是一个通用 agent 工作流与工程技能集，可安装到 Codex、Claude Code 与 DeepSeek Harness 中。插件本身基于 JavaScript，零依赖，不需要额外的 MCP 服务。它通过复用项目已有的测试和审计工具，为不同的 Agent 任务提供标准化的执行路径。
核心功能¶
插件包含八个核心技能，覆盖从调研到实施的全流程：
- 调研取证：负责代码与日志调查、证据链收集和报告生成。
- 测试设计：依据业务规则和项目现有设施，设计用例、评估场景缺口并制定验证办法。该技能仅交付设计，不编写或执行测试。
- Bug 调试：复现问题、验证根因。执行时会展示原因、证据和修复方案，在用户同意后再进行修复与回归验证。
- 架构调查：用户主动发起的架构机会检查，支持并行取证，允许零候选结果。
- 实施工作流：支持任务拆分、串行或并行实施，以及集成验证与按风险审计。
- 差异评审：分别从 Correctness（正确性）、Standards（规范）和 Spec（规格）三个轴独立进行评审。
- 复杂度审计：评估复杂度与覆盖率风险。当数据不足时，明确给出降级方案。
- 突变测试：调用现有的突变测试工具，查找存活突变体以发现测试漏洞。
安装与启用¶
在 DeepSeek Harness 中安装该插件：
dsh plugin --profile web add github:Lixiuxiu559/AgentForge
安装完成后，需要重启该 profile 才能使插件生效。由于本插件未发布到 npm，DSH 侧没有按版本号升级的途径。
典型用法¶
在对话中直接调用对应的技能即可：
- 调查错误调用链：用
research调查这个错误的调用链，给出证据和未确认项。 - 设计测试用例：用
test-design为这项功能设计测试用例，检查业务边界、异常和状态变化是否覆盖充分。 - 排查异常：用
bug-debugging排查这个异常，先说明原因和修复方案，等我同意后再改。 - 实施功能：用
implementation-workflow实现这个功能，独立模块可以并行。 - 评审改动：用
diff-review评审当前改动，分别报告三条轴的结果。 - 架构检查：用
architecture-scout检查这个模块是否有值得提炼的边界。
适用场景与注意事项¶
该插件适合需要结构化工作流、统一测试标准和严格评审流程的项目。
需要特别注意以下几点：
1. 独立上下文隔离：独立上下文并不隔离文件系统。因此，对于同文件的修改或共享构建产物等操作，仍需安排互斥，避免冲突。
2. Git 安装机制：通过 git 安装没有版本门控，lockfile 里钉的是具体 commit。update 操作会将版本跟到 main 分支的最新提交，相当于 main 分支即发布通道。
3. 审批机制：bug-debugging 技能在修复前需要用户明确同意方案，单纯的“帮我修好”请求不会自动跳过审批步骤。
后续¶
AgentForge 将技能统一维护在 skills/ 目录下，旨在通过一套代码服务多个平台。完整的使用说明和项目结构可参考项目主页。
