用途:从 Issue、计划文件或自由文本描述出发,按项目规范实现功能或修复缺陷。输入主参数($ARGUMENTS)为 Issue 编号/URL、计划文件路径或自由文本,可用 -- 追加执行上下文;--unattended 跳过计划确认并无人值守执行。
流程:先理解工作内容,识别输入类型并提取需求;Issue 模式下获取标题、需求、验收标准、标签、子问题与评论,子问题逐个完成并关闭。随后制定方案:识别数据模型、API 契约、模块边界等持久架构决策,复杂工作可委派 forge-scout 子代理研究代码库(仅提供研究问题,不提供 Issue),产出计划后用 AskUserQuestion 获取确认(无人值守模式跳过)。
接着创建功能分支,先 git fetch origin,再从默认分支切出:git checkout --no-track -b <TYPE>/<ISSUE_NUMBER>-<BRIEF_DESCRIPTION> origin/$DEFAULT_BRANCH。实现时先读 AGENTS.md,按垂直阶段推进,每阶段代码与测试同做,通过阶段门(测试通过、无新增 lint/类型错误、提交一个逻辑变更)后再进入下一阶段。之后审计模式一致性、更新文档、跑最终质量门(lint、格式、类型检查、测试、新改代码覆盖率≥90%),最后推送并用 heredoc 传 PR 正文:gh pr create --title ... --body-file - <<'PR_EOF'。
适用与限制:适用于有明确项目规范和 Issue/计划来源的功能开发与修复。需求过于含糊或依赖不完整时应请求澄清;无人值守模式改为基于明确假设继续。是否支持子代理、覆盖率工具是否已配置等取决于具体项目;资料未提供安装方式、收费或平台信息。