用途:create-harness 用于脚手架生成一个专属、聚焦且带品牌的 AI 智能体 harness,包含自己的 npx <name> CLI、MCP 服务器注册、记忆命名空间、学习循环和市场身份。适用场景包括:自建 MCP 服务器驱动的 AI 助手(法律、交易、支持、运维等)、打包自有 agents/skills/prompts 的 Claude Code 插件、封装 kernel + tools 的 Codex skill、pi.dev 扩展或 Hermes 智能体运行时配置,以及可发布到 npm 的独立包。
调用方式:使用命令 /create-harness。该技能会询问 harness 名称(kebab-case,如 legal-redline)、一行描述、宿主(Claude Code、Codex、pi.dev、Hermes,可多选)、模板(minimal 默认,或 vertical:trading、vertical:support、vertical:devops、vertical:legal、vertical:research,或 eject-from-ruflo)、记忆后端(AgentDB 默认、SQLite-only、in-memory)、路由策略(3-tier 默认或 single-tier)、市场身份(independent 或 powered-by)。
内部机制:调用 npx create-agent-harness <name>,将所选模板复制到当前目录,运行生成后冒烟测试,并生成 .harness/manifest.json 以便后续用 copier 风格的 regenerate-diff-merge 升级。
输出物包括:package.json(可直接 npm publish 的包)、bin/<name>.js(CLI 入口)、.claude/settings.json(Claude Code 宿主的 MCP + hooks 接线)、.codex/config.toml(Codex 宿主的 MCP 表)、AGENTS.md 与 SYSTEM.md(pi.dev 宿主扩展说明)、cli-config.yaml(Hermes 运行时配置)、.harness/manifest.json(生成器状态,驱动漂移检测)、witness.json(Ed25519 签名的来源清单)。
生成后用户可执行:cd <name>、npm install、npm test、npm publish,其用户通过 npx <name> init 使用。
注意事项:这是确定性操作,实际文件创建交由 create-agent-harness,不要自行生成 harness 文件内容;witness 清单为必需项,不可跳过。若用户想要某领域的 ruflo,优先推荐 vertical:<X> 模板,minimal 作为后备。支持多宿主,但会增大 harness 表面积,首次使用建议单宿主。