用途:Agent Handoff 用于在多智能体项目中创建并维护 .ai/ 共享上下文目录,使不同 AI 代理之间能够无缝交接工作。常驻的读写行为由安装时注入各代理配置文件的片段负责,本技能处理更重的操作:首次引导、过期检测和项目扫描。触发条件包括用户提到 agent handoff、bootstrap、initialize、continue、resume 等,或 .ai/ 核心文件缺失、为空、仍是占位符,或 HANDOFF.md 超过 7 天未更新。
主要能力:
- 首次引导:创建 .ai/conversations/decisions 与 .ai/conversations/sessions 目录,检测项目类型与技术栈(读取 package.json、composer.json、Gemfile、go.mod、Cargo.toml 等清单及 CLAUDE.md、AGENTS.md、.cursorrules 等配置文件),发现文档(根目录、docs/、specs/、API 文档等并分类分级),检测 spec/plan 目录模式,生成 PROJECT.md、PATHS.md、PLAN.md、HANDOFF.md、LOG.md。
- 向各代理配置文件注入常驻片段,配置项覆盖 Claude Code 的 CLAUDE.md、Codex 的 codex.md、AGENTS.md、Cursor 的 .cursorrules、Windsurf 的 .windsurfrules、Gemini 的 GEMINI.md、OpenCode 的 .opencode/instructions.md、GitHub Copilot 的 .github/copilot-instructions.md。
- 过期检测:HANDOFF.md 超过 7 天、PATHS.md 引用不存在的文件时进行核对与刷新。
使用方式:用户提及相关关键词或执行 /agent-handoff 时触发。引导时先建目录,再检测技术栈与文档,然后按模板生成上下文文件,并使用真实本地时间(如 date '+%Y-%m-%d %H:%M %Z')。每个任务完成后,代理需向 LOG.md 追加记录、必要时更新 HANDOFF.md,并在会话目录创建时间戳文件。
限制与注意:设有文件行数上限(LOG.md 约 500 行,超出归档);代理并发时 HANDOFF.md 可能冲突,需按规则合并;具体模板与示例参见 references/templates.md 与 references/examples.md。官方价格、支持平台细节及完整安装命令暂未提供。