Ruflo Agent 技能解析base-template-generator 基础模板生成器的定义、调用机制与源码级实现【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo本篇围绕 Rufloruvnet/claude-flow 生态仓库中的 .agents/skills/agent-base-template-generator/SKILL.md 展开完整讲解这个基础模板生成器Agent 技能的职责定义、六步生成方法论、覆盖的模板类别与质量标准并结合 .agents/config.toml、.agents/README.md、模板注册表 与 Docker 回归测试脚本 说明该技能如何被 Codex CLI 加载、通过$skill-name语法调用、以及如何被自动化测试覆盖。读完你可以掌握 Ruflo 中 Agent 技能SKILL.md的 frontmatter 规范、技能装配流程以及把模板生成固化为可复用 Agent 能力的完整路径。1. 技能定位一个专门产出地基代码的 Agentbase-template-generator是 Ruflo 项目中定义在 .agents/skills/agent-base-template-generator/SKILL.md 的一个 Agent 技能。它的定位非常聚焦为新的项目、组件或功能创建基础模板foundational templates、样板代码boilerplate code或起步配置starter configurations。从 SKILL.md 的角色定义看该 Agent 被描述为一位专家级架构师expert architect专长是创建干净、结构良好的基础模板与样板代码。它的核心价值主张有三点遵循行业最佳实践产出的模板不是随手写的骨架而是建立在成熟工程规范之上的起点保持一致性所有模板都要对齐项目既有的编码标准与约定SKILL.md 明确提到要遵循项目 CLAUDE.md 指南中的标准提供清晰的扩展路径模板必须模块化、可扩展让使用者能够轻松按具体需求定制。SKILL.md 的 description 字段给出了两个典型触发场景这也是理解该技能何时该用的关键新建 React 组件用户说I need to create a new user profile componentAgent 应产出包含完整结构、TypeScript 定义与样式设置的组件模板新建 REST API 端点用户请求搭建用户管理的 API 端点Agent 应产出包含错误处理、参数校验与文档结构的完整端点模板。这两个例子共同说明了该技能的边界它处理的是从无到有的基础结构搭建而不是既有代码的修复或重构。2. 文件结构双层 YAML frontmatter 与调用方式Ruflo 的 Agent 技能文件采用 SKILL.md 约定每个技能一个独立目录skills/skill-name/SKILL.md目录下可选配scripts/脚本与docs/文档。这一目录结构规范定义在 .agents/README.md 中.agents/ config.toml # Main configuration file skills/ # Skill definitions skill-name/ SKILL.md # Skill instructions scripts/ # Optional scripts docs/ # Optional documentation具体到agent-base-template-generator这个技能其 SKILL.md 包含两层YAML frontmatter这体现了 Ruflo 技能体系的一个细节——外层是技能封装元数据内层是被封装 Agent 的原始定义外层 frontmatter技能封装层name: agent-base-template-generator description: Agent skill for base-template-generator - invoke with $agent-base-template-generator它声明了技能名并直接写明调用方式通过$agent-base-template-generator语法触发。根据 .agents/README.md 的说明Ruflo 中的技能统一使用$skill-name语法调用。内层 frontmatterAgent 定义层name: base-template-generator description: Use this agent when you need to create foundational templates, boilerplate code, or starter configurations for ... Examples: exampleContext: ... /example ... color: orange这里除了 Agent 名称与含示例example块的描述外还有一个值得注意的字段color: orange。该字段不在 .agents 目录的通用规范文档中单独展开从结构上看它属于 Agent 的展示/标识元数据。这种技能名带agent-前缀、内部 Agent 名不带前缀的命名对应关系可以在仓库中找到更多旁证仓库中还存在一个平行的纯 Agent 定义文件 plugin/agents/base-template-generator.md其正文内容与 SKILL.md 中内层 Agent 定义完全一致——即项目同时维护了Agent 定义与Agent 技能封装两份产物SKILL.md 是把 Agent 定义包装成可通过$语法调用的技能载体。3. 核心职责SKILL.md 原文逐项解读SKILL.md 正文的 core responsibilities核心职责部分列出了六条硬性要求构成该 Agent 的行为契约职责含义与工程落点生成组件、模块、API、配置与项目结构的综合基础模板模板覆盖面不局限于前端而是横跨整个工程面确保所有模板遵循项目 CLAUDE.md 中的编码标准与最佳实践模板不是脱离项目上下文的通用物必须对齐项目既有规范包含完善的 TypeScript 类型定义、错误处理与文档结构类型安全与可观测性错误路径是默认交付物创建模块化、可扩展、可定制的模板预留扩展点而非一次性硬编码引入配套的测试脚手架与配置文件模板自带 test scaffolding而非事后补在适用时遵循 SPARC 方法论原则与 Ruflo 的 SPARCSpecification → Pseudocode → Architecture → Refinement → Code方法论对齐最后一条值得展开Ruflo 仓库中 SPARC 方法论是一个独立体系例如 .agents/skills/sparc-methodology/SKILL.md 就携带了sparc-init.sh、sparc-review.sh等配套脚本tests/docker-regression/scripts/test-agents.sh 中也将 SPARC 各阶段拆分为sparc-coord、specification、pseudocode、architecture、refinement等独立 Agent 逐一测试。base-template-generator声明Follow SPARC methodology principles when applicable意味着当用户需求可以拆解为规格驱动的流程时它产出的模板应当能与 SPARC 各阶段 Agent 协作而不是孤立输出。4. 六步模板生成方法论SKILL.md 给出了明确的六步工作流template generation approach这是对 Agent 输出质量的直接约束Analyze Requirements需求分析先弄清需要什么类型的模板、目标用途是什么Apply Best Practices套用最佳实践从项目上下文中引入编码标准、命名约定与架构模式Structure Foundation构建基础结构创建清晰的文件组织、正确的 imports/exports 与合理的代码结构Include Essentials补齐必备项加入错误处理、类型安全、文档注释与基础校验Enable Extension预留扩展点设计清晰的扩展区域与定制区Provide Context提供上下文说明用注释解释模板各区块的用途与定制选项。这六步实际上回答了一个常见问题——为什么模板生成 Agent 的输出常常是能跑但不敢改的死代码SKILL.md 的答案是通过第 5、6 步把扩展性与自解释性显式纳入交付标准模板不仅要当下能工作还要让使用者知道哪里可以改、怎么改。5. 覆盖的七大模板类别与质量标准SKILL.md 列出了该 Agent 擅长的模板类别template categories覆盖了前后端与工程化的主要场景React/Vue 组件带正确的生命周期管理API 端点带参数校验与错误处理数据库模型与 Schema配置文件与环境设置测试套件与测试工具文档模板与 README 结构构建与部署配置。与之配套的是质量基线quality standards五条可检验的验收条件开箱即用所有模板在最小修改下必须立即可运行immediately functional with minimal modification类型完备在适用处提供完整的 TypeScript 类型遵循项目既有模式与约定留有清晰的占位定制区附带相关 imports、依赖、有意义的默认值与示例。SKILL.md 的收尾段落进一步强调了上下文意识生成模板时始终要考虑更宏观的项目上下文、既有模式与未来的扩展性需求。模板应作为加速开发同时保持代码质量与一致性的坚实地基solid foundations that accelerate development while maintaining code quality and consistency。6. 技能如何被加载与启用.agents/config.toml 的配置机制理解了 SKILL.md 本身还需要理解它在 Ruflo/Codex 集成中的装配方式。这由 .agents/config.toml 控制。6.1 目录与文档发现config.toml 头部注释说明该文件由claude-flow/codex生成应放置在项目级.agents/config.toml或用户级.codex/config.toml。与技能发现相关的配置有两处# Maximum bytes to read from AGENTS.md files project_doc_max_bytes 65536 # Fallback filenames if AGENTS.md not found project_doc_fallback_filenames [ AGENTS.md, TEAM_GUIDE.md, .agents.md ]以及特性开关中的child_agents_md true启用子目录 AGENTS.md 引导。这些决定了 Agent 会话启动时能看到哪些项目指导文档——而base-template-generator的职责之一正是让模板遵循 CLAUDE.md/AGENTS.md 中的规范两者在此形成闭环。6.2 技能的显式启用config.toml 通过[[skills.config]]数组显式声明启用的技能路径当前仓库中启用的是四个高频技能[[skills.config]] path .agents/skills/swarm-orchestration enabled true [[skills.config]] path .agents/skills/memory-management enabled true [[skills.config]] path .agents/skills/sparc-methodology enabled true [[skills.config]] path .agents/skills/security-audit enabled true可以推断.agents/skills/目录下的全部技能包括agent-base-template-generator该目录下共有 130 个技能目录中只有列入[[skills.config]]的会被 Codex CLI 默认加载其余可通过同样的方式追加启用例如[[skills.config]] path .agents/skills/agent-base-template-generator enabled true启用后即在会话中通过$agent-base-template-generator调用该技能。6.3 与 MCP 服务的关系同一份配置中还定义了 Claude Flow 的 MCP 服务接入[mcp_servers.claude-flow] command npx args [-y, claude-flow/clilatest] enabled true tool_timeout_sec 120这意味着 Codex 会话中base-template-generator技能生成的模板还可以直接调用 Ruflo 的 MCP 工具如记忆、任务、钩子命名空间做后续编排——技能负责产出模板MCP 层负责在项目中落地模板二者分工清晰。7. 源码级佐证模板注册表与自动化回归测试7.1 Codex 模板生成器中的 Agent 注册在 v3/claude-flow/codex/src/templates/index.ts 中Ruflo 维护了一份AGENTS_MD_TEMPLATE可用的完整 Agent 清单ALL_AVAILABLE_AGENTS其中明确登记了agent-base-template-generator位于清单的专项开发类区段与agent-dev-backend-api、agent-pseudocode、agent-specification、agent-architecture等并列。同一文件中还定义了不同模板minimal/default/full/enterprise各自默认携带的技能集合export const DEFAULT_SKILLS_BY_TEMPLATE: RecordAgentsMdTemplate, string[] { minimal: [swarm-orchestration, memory-management], default: [swarm-orchestration, memory-management, sparc-methodology, security-audit], full: ALL_AVAILABLE_SKILLS, enterprise: ALL_AVAILABLE_SKILLS, };这说明在 AGENTS.md 的初始化模板体系中agent-base-template-generator属于全量清单成员选择 full 或 enterprise 模板的项目会自动获得包含该 Agent 在内的完整 Agent 清单。这与 SKILL.md 本身的职责相呼应——它既是被模板系统分发的 Agent也是专门生成模板的 Agent在 Ruflo 的元框架meta-harness定位下形成了一层有趣的自指结构。7.2 Docker 回归测试覆盖tests/docker-regression/scripts/test-agents.sh 是仓库的Agent 能力测试套件头部注释写明Tests all 54 agents for basic functionality。该脚本通过test_agent函数逐个验证 Agent 可加载# Test agent exists and is loadable test_agent() { local agent_name$1 run_test Agent: ${agent_name} npx claude-flow agent info ${agent_name} 2/dev/null || echo agent: ${agent_name} }base-template-generator被归类在Specialized Development Agents专项开发 Agent分组中与backend-dev、mobile-dev、ml-developer、system-architect、code-analyzer等并列测试echo ── Specialized Development Agents ── test_agent backend-dev test_agent mobile-dev test_agent ml-developer test_agent cicd-engineer test_agent api-docs test_agent system-architect test_agent code-analyzer test_agent base-template-generator测试逻辑是执行npx claude-flow agent info agent-name以退出码判定通过与否。可以推断该测试保证base-template-generator在claude-flow/cli的 Agent 注册表中可被查询agent info能命中该名称从而验证 SKILL.md / Agent 定义与 CLI 端注册表的一致性没有漂移。整个套件运行在 tests/docker-regression 的 Docker 环境中含 Dockerfile、docker-compose.yml 与 Makefile适合作为技能改动后的回归验证手段。8. 实践指南从技能定义到实际使用的完整路径结合上述证据使用base-template-generator技能的完整路径是确认技能文件存在查看 .agents/skills/agent-base-template-generator/SKILL.md确认技能名与调用语法$agent-base-template-generator在 Codex 配置中启用在项目级 .agents/config.toml或用户级.codex/config.toml中添加对应的[[skills.config]]段指向.agents/skills/agent-base-template-generator并设置enabled true发起调用在 Codex 会话中用$agent-base-template-generator触发或直接描述模板需求如为新的用户管理 REST API 端点生成模板Agent 将按 SKILL.md 定义的六步流程产出模板验收产出对照 SKILL.md 的质量标准检查——是否立即可运行、是否有完整 TypeScript 类型、是否预留扩展点与定制注释、是否附带测试脚手架回归验证改动技能或 Agent 定义后运行 tests/docker-regression/scripts/test-agents.sh 确认base-template-generator仍处于可加载状态npx claude-flow agent info base-template-generator。9. 小结.agents/skills/agent-base-template-generator/SKILL.md 是 Ruflo Agent 技能体系的一个典型样本它用双层 frontmatter 完成技能封装 Agent 定义的结构化声明用六条核心职责、六步方法论、七大模板类别与五条质量标准定义了基础模板生成这一工程角色的完整行为契约并声明了与项目 CLAUDE.md 规范和 SPARC 方法论的对齐关系。仓库中的 .agents/config.toml 提供其加载与启用机制模板注册表源码 证明它是 AGENTS.md 初始化模板体系中的登记成员而 Docker 回归测试 为其可加载性提供了自动化保障。对希望复用该能力或仿照其结构定义自己技能skill的开发者而言这个文件是一个可直接参考的完整范例。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Ruflo Agent 技能解析：base-template-generator 基础模板生成器的定义、调用机制与源码级实现
Ruflo Agent 技能解析base-template-generator 基础模板生成器的定义、调用机制与源码级实现【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo本篇围绕 Rufloruvnet/claude-flow 生态仓库中的 .agents/skills/agent-base-template-generator/SKILL.md 展开完整讲解这个基础模板生成器Agent 技能的职责定义、六步生成方法论、覆盖的模板类别与质量标准并结合 .agents/config.toml、.agents/README.md、模板注册表 与 Docker 回归测试脚本 说明该技能如何被 Codex CLI 加载、通过$skill-name语法调用、以及如何被自动化测试覆盖。读完你可以掌握 Ruflo 中 Agent 技能SKILL.md的 frontmatter 规范、技能装配流程以及把模板生成固化为可复用 Agent 能力的完整路径。1. 技能定位一个专门产出地基代码的 Agentbase-template-generator是 Ruflo 项目中定义在 .agents/skills/agent-base-template-generator/SKILL.md 的一个 Agent 技能。它的定位非常聚焦为新的项目、组件或功能创建基础模板foundational templates、样板代码boilerplate code或起步配置starter configurations。从 SKILL.md 的角色定义看该 Agent 被描述为一位专家级架构师expert architect专长是创建干净、结构良好的基础模板与样板代码。它的核心价值主张有三点遵循行业最佳实践产出的模板不是随手写的骨架而是建立在成熟工程规范之上的起点保持一致性所有模板都要对齐项目既有的编码标准与约定SKILL.md 明确提到要遵循项目 CLAUDE.md 指南中的标准提供清晰的扩展路径模板必须模块化、可扩展让使用者能够轻松按具体需求定制。SKILL.md 的 description 字段给出了两个典型触发场景这也是理解该技能何时该用的关键新建 React 组件用户说I need to create a new user profile componentAgent 应产出包含完整结构、TypeScript 定义与样式设置的组件模板新建 REST API 端点用户请求搭建用户管理的 API 端点Agent 应产出包含错误处理、参数校验与文档结构的完整端点模板。这两个例子共同说明了该技能的边界它处理的是从无到有的基础结构搭建而不是既有代码的修复或重构。2. 文件结构双层 YAML frontmatter 与调用方式Ruflo 的 Agent 技能文件采用 SKILL.md 约定每个技能一个独立目录skills/skill-name/SKILL.md目录下可选配scripts/脚本与docs/文档。这一目录结构规范定义在 .agents/README.md 中.agents/ config.toml # Main configuration file skills/ # Skill definitions skill-name/ SKILL.md # Skill instructions scripts/ # Optional scripts docs/ # Optional documentation具体到agent-base-template-generator这个技能其 SKILL.md 包含两层YAML frontmatter这体现了 Ruflo 技能体系的一个细节——外层是技能封装元数据内层是被封装 Agent 的原始定义外层 frontmatter技能封装层name: agent-base-template-generator description: Agent skill for base-template-generator - invoke with $agent-base-template-generator它声明了技能名并直接写明调用方式通过$agent-base-template-generator语法触发。根据 .agents/README.md 的说明Ruflo 中的技能统一使用$skill-name语法调用。内层 frontmatterAgent 定义层name: base-template-generator description: Use this agent when you need to create foundational templates, boilerplate code, or starter configurations for ... Examples: exampleContext: ... /example ... color: orange这里除了 Agent 名称与含示例example块的描述外还有一个值得注意的字段color: orange。该字段不在 .agents 目录的通用规范文档中单独展开从结构上看它属于 Agent 的展示/标识元数据。这种技能名带agent-前缀、内部 Agent 名不带前缀的命名对应关系可以在仓库中找到更多旁证仓库中还存在一个平行的纯 Agent 定义文件 plugin/agents/base-template-generator.md其正文内容与 SKILL.md 中内层 Agent 定义完全一致——即项目同时维护了Agent 定义与Agent 技能封装两份产物SKILL.md 是把 Agent 定义包装成可通过$语法调用的技能载体。3. 核心职责SKILL.md 原文逐项解读SKILL.md 正文的 core responsibilities核心职责部分列出了六条硬性要求构成该 Agent 的行为契约职责含义与工程落点生成组件、模块、API、配置与项目结构的综合基础模板模板覆盖面不局限于前端而是横跨整个工程面确保所有模板遵循项目 CLAUDE.md 中的编码标准与最佳实践模板不是脱离项目上下文的通用物必须对齐项目既有规范包含完善的 TypeScript 类型定义、错误处理与文档结构类型安全与可观测性错误路径是默认交付物创建模块化、可扩展、可定制的模板预留扩展点而非一次性硬编码引入配套的测试脚手架与配置文件模板自带 test scaffolding而非事后补在适用时遵循 SPARC 方法论原则与 Ruflo 的 SPARCSpecification → Pseudocode → Architecture → Refinement → Code方法论对齐最后一条值得展开Ruflo 仓库中 SPARC 方法论是一个独立体系例如 .agents/skills/sparc-methodology/SKILL.md 就携带了sparc-init.sh、sparc-review.sh等配套脚本tests/docker-regression/scripts/test-agents.sh 中也将 SPARC 各阶段拆分为sparc-coord、specification、pseudocode、architecture、refinement等独立 Agent 逐一测试。base-template-generator声明Follow SPARC methodology principles when applicable意味着当用户需求可以拆解为规格驱动的流程时它产出的模板应当能与 SPARC 各阶段 Agent 协作而不是孤立输出。4. 六步模板生成方法论SKILL.md 给出了明确的六步工作流template generation approach这是对 Agent 输出质量的直接约束Analyze Requirements需求分析先弄清需要什么类型的模板、目标用途是什么Apply Best Practices套用最佳实践从项目上下文中引入编码标准、命名约定与架构模式Structure Foundation构建基础结构创建清晰的文件组织、正确的 imports/exports 与合理的代码结构Include Essentials补齐必备项加入错误处理、类型安全、文档注释与基础校验Enable Extension预留扩展点设计清晰的扩展区域与定制区Provide Context提供上下文说明用注释解释模板各区块的用途与定制选项。这六步实际上回答了一个常见问题——为什么模板生成 Agent 的输出常常是能跑但不敢改的死代码SKILL.md 的答案是通过第 5、6 步把扩展性与自解释性显式纳入交付标准模板不仅要当下能工作还要让使用者知道哪里可以改、怎么改。5. 覆盖的七大模板类别与质量标准SKILL.md 列出了该 Agent 擅长的模板类别template categories覆盖了前后端与工程化的主要场景React/Vue 组件带正确的生命周期管理API 端点带参数校验与错误处理数据库模型与 Schema配置文件与环境设置测试套件与测试工具文档模板与 README 结构构建与部署配置。与之配套的是质量基线quality standards五条可检验的验收条件开箱即用所有模板在最小修改下必须立即可运行immediately functional with minimal modification类型完备在适用处提供完整的 TypeScript 类型遵循项目既有模式与约定留有清晰的占位定制区附带相关 imports、依赖、有意义的默认值与示例。SKILL.md 的收尾段落进一步强调了上下文意识生成模板时始终要考虑更宏观的项目上下文、既有模式与未来的扩展性需求。模板应作为加速开发同时保持代码质量与一致性的坚实地基solid foundations that accelerate development while maintaining code quality and consistency。6. 技能如何被加载与启用.agents/config.toml 的配置机制理解了 SKILL.md 本身还需要理解它在 Ruflo/Codex 集成中的装配方式。这由 .agents/config.toml 控制。6.1 目录与文档发现config.toml 头部注释说明该文件由claude-flow/codex生成应放置在项目级.agents/config.toml或用户级.codex/config.toml。与技能发现相关的配置有两处# Maximum bytes to read from AGENTS.md files project_doc_max_bytes 65536 # Fallback filenames if AGENTS.md not found project_doc_fallback_filenames [ AGENTS.md, TEAM_GUIDE.md, .agents.md ]以及特性开关中的child_agents_md true启用子目录 AGENTS.md 引导。这些决定了 Agent 会话启动时能看到哪些项目指导文档——而base-template-generator的职责之一正是让模板遵循 CLAUDE.md/AGENTS.md 中的规范两者在此形成闭环。6.2 技能的显式启用config.toml 通过[[skills.config]]数组显式声明启用的技能路径当前仓库中启用的是四个高频技能[[skills.config]] path .agents/skills/swarm-orchestration enabled true [[skills.config]] path .agents/skills/memory-management enabled true [[skills.config]] path .agents/skills/sparc-methodology enabled true [[skills.config]] path .agents/skills/security-audit enabled true可以推断.agents/skills/目录下的全部技能包括agent-base-template-generator该目录下共有 130 个技能目录中只有列入[[skills.config]]的会被 Codex CLI 默认加载其余可通过同样的方式追加启用例如[[skills.config]] path .agents/skills/agent-base-template-generator enabled true启用后即在会话中通过$agent-base-template-generator调用该技能。6.3 与 MCP 服务的关系同一份配置中还定义了 Claude Flow 的 MCP 服务接入[mcp_servers.claude-flow] command npx args [-y, claude-flow/clilatest] enabled true tool_timeout_sec 120这意味着 Codex 会话中base-template-generator技能生成的模板还可以直接调用 Ruflo 的 MCP 工具如记忆、任务、钩子命名空间做后续编排——技能负责产出模板MCP 层负责在项目中落地模板二者分工清晰。7. 源码级佐证模板注册表与自动化回归测试7.1 Codex 模板生成器中的 Agent 注册在 v3/claude-flow/codex/src/templates/index.ts 中Ruflo 维护了一份AGENTS_MD_TEMPLATE可用的完整 Agent 清单ALL_AVAILABLE_AGENTS其中明确登记了agent-base-template-generator位于清单的专项开发类区段与agent-dev-backend-api、agent-pseudocode、agent-specification、agent-architecture等并列。同一文件中还定义了不同模板minimal/default/full/enterprise各自默认携带的技能集合export const DEFAULT_SKILLS_BY_TEMPLATE: RecordAgentsMdTemplate, string[] { minimal: [swarm-orchestration, memory-management], default: [swarm-orchestration, memory-management, sparc-methodology, security-audit], full: ALL_AVAILABLE_SKILLS, enterprise: ALL_AVAILABLE_SKILLS, };这说明在 AGENTS.md 的初始化模板体系中agent-base-template-generator属于全量清单成员选择 full 或 enterprise 模板的项目会自动获得包含该 Agent 在内的完整 Agent 清单。这与 SKILL.md 本身的职责相呼应——它既是被模板系统分发的 Agent也是专门生成模板的 Agent在 Ruflo 的元框架meta-harness定位下形成了一层有趣的自指结构。7.2 Docker 回归测试覆盖tests/docker-regression/scripts/test-agents.sh 是仓库的Agent 能力测试套件头部注释写明Tests all 54 agents for basic functionality。该脚本通过test_agent函数逐个验证 Agent 可加载# Test agent exists and is loadable test_agent() { local agent_name$1 run_test Agent: ${agent_name} npx claude-flow agent info ${agent_name} 2/dev/null || echo agent: ${agent_name} }base-template-generator被归类在Specialized Development Agents专项开发 Agent分组中与backend-dev、mobile-dev、ml-developer、system-architect、code-analyzer等并列测试echo ── Specialized Development Agents ── test_agent backend-dev test_agent mobile-dev test_agent ml-developer test_agent cicd-engineer test_agent api-docs test_agent system-architect test_agent code-analyzer test_agent base-template-generator测试逻辑是执行npx claude-flow agent info agent-name以退出码判定通过与否。可以推断该测试保证base-template-generator在claude-flow/cli的 Agent 注册表中可被查询agent info能命中该名称从而验证 SKILL.md / Agent 定义与 CLI 端注册表的一致性没有漂移。整个套件运行在 tests/docker-regression 的 Docker 环境中含 Dockerfile、docker-compose.yml 与 Makefile适合作为技能改动后的回归验证手段。8. 实践指南从技能定义到实际使用的完整路径结合上述证据使用base-template-generator技能的完整路径是确认技能文件存在查看 .agents/skills/agent-base-template-generator/SKILL.md确认技能名与调用语法$agent-base-template-generator在 Codex 配置中启用在项目级 .agents/config.toml或用户级.codex/config.toml中添加对应的[[skills.config]]段指向.agents/skills/agent-base-template-generator并设置enabled true发起调用在 Codex 会话中用$agent-base-template-generator触发或直接描述模板需求如为新的用户管理 REST API 端点生成模板Agent 将按 SKILL.md 定义的六步流程产出模板验收产出对照 SKILL.md 的质量标准检查——是否立即可运行、是否有完整 TypeScript 类型、是否预留扩展点与定制注释、是否附带测试脚手架回归验证改动技能或 Agent 定义后运行 tests/docker-regression/scripts/test-agents.sh 确认base-template-generator仍处于可加载状态npx claude-flow agent info base-template-generator。9. 小结.agents/skills/agent-base-template-generator/SKILL.md 是 Ruflo Agent 技能体系的一个典型样本它用双层 frontmatter 完成技能封装 Agent 定义的结构化声明用六条核心职责、六步方法论、七大模板类别与五条质量标准定义了基础模板生成这一工程角色的完整行为契约并声明了与项目 CLAUDE.md 规范和 SPARC 方法论的对齐关系。仓库中的 .agents/config.toml 提供其加载与启用机制模板注册表源码 证明它是 AGENTS.md 初始化模板体系中的登记成员而 Docker 回归测试 为其可加载性提供了自动化保障。对希望复用该能力或仿照其结构定义自己技能skill的开发者而言这个文件是一个可直接参考的完整范例。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考