用途：为 code-forge 应用创建和管理智能体。智能体是具备特定能力、工具与行为的专用 AI 助手，以 Markdown 文件形式保存。
文件位置：所有智能体文件必须放在 <cwd>/.forge/agents 目录（<cwd> 为 code-forge 项目当前工作目录），文件名格式为 {agent-id}.md。这是 forge 发现并加载自定义智能体的唯一位置，放在其他位置不会被识别。
文件结构：每个智能体文件包含两部分。一是必需的 YAML frontmatter，字段有 id（唯一标识，小写加连字符）、title（显示名称）、description（用途、能力与使用时机说明）、reasoning（目前仅支持 enabled: true/false）、tools（可用工具列表，每行以 - 前缀，支持 mcp_* 通配符）、user_prompt（用户上下文模板，需包含事件处理与系统日期，标准格式为 user_prompt: |- <{{event.name}}>{{event.value}}</{{event.name}}> <system_date>{{current_date}}</system_date>）。二是智能体正文，通常包含身份与目的、核心原则、能力、方法论、最佳实践、限制与边界。
可用工具：核心工具包括 sem_search（语义代码搜索）、search / fs_search（正则搜索）、read、write、patch、undo、remove、shell、fetch、skill；特殊工具包括 sage（深度代码库研究智能体）与 mcp_*（所有 MCP 工具通配符）。可按用途选择：实现类智能体常用 read、write、patch、shell、sem_search、fs_search；研究类常用 sem_search、search、read、fetch、sage；规划类常用 sem_search、sage、read、write、fetch。
常见智能体类型：实现类（如 forge，直接修改代码库）、研究类（如 sage，只读分析）、规划类（如 muse，只输出计划，任务用 Markdown 复选框表示）。
创建步骤：确定智能体用途与所需工具，选择描述性的 id 与 title，在 <cwd>/.forge/agents 下创建 {agent-id}.md 并填写 frontmatter 与正文。
限制：文件必须位于指定目录；reasoning 目前仅支持开关；研究类与规划类智能体不应执行修改，被要求时应说明限制并建议改用实现类智能体。其他收费、平台与效果信息暂未提供。