Multi-Agent Handoff Coding

中文 | English

中文

还在为中途切换 AI 苦恼吗？

还在为新 AI 一脸茫然、不知道前面发生了什么、代码改到一半上下文断片、验证没跑、交接文档没人写而头疼吗？

这个仓库就是给这种场景准备的：它把“多 AI 接手混合编码”变成一套可导入、可复用、可验证的工作技能。让 Codex、Claude Code、Hermes 或其他 coding agent 都先读项目、再小步修改、跑验证、更新项目记忆、留下交接入口，而不是每次从零猜。

它解决什么

• 切换 AI 之后，新模型不知道当前项目状态。
• 上一次改了什么、验证了什么、还剩什么风险没人记录。
• 文档、代码、发布说明不同步。
• AI 喜欢直接动手，但不读项目规则、不跑验证。
• 项目想开源或转发给别人，又担心本地路径、邮箱、私密信息泄漏。

核心能力

• 让 AI 先读项目文档、代码和 git 状态，再开始改。
• 要求 AI 保持最小必要修改，不乱动无关文件。
• 根据任务风险运行 build、lint、test、截图、接口请求等验证。
• 把 PROJECT.md、HANDOFF.md、MEMORY_UPDATES.md、CHANGELOG_AI.md 这类交接文档纳入完成标准。
• 在公开 README、交接总结、发布说明前做隐私扫描。
• 给 Codex、Claude Code、Hermes 和通用 agent 都提供可读取入口。

仓库结构

.
|-- SKILL.md
|-- AGENTS.md
|-- CLAUDE.md
|-- HERMES.md
|-- agents/openai.yaml
|-- assets/templates/
|-- references/
`-- scripts/privacy_scan.py

安装与使用

Codex

把仓库克隆到 Codex skills 目录：

mkdir -p ~/.codex/skills
git clone https://github.com/yuan-666/multi-agent-handoff-coding.git ~/.codex/skills/multi-agent-handoff-coding

然后在需要项目接手、验证、记忆同步时，让 Codex 使用 multi-agent-handoff-coding。

Claude Code

把 CLAUDE.md 放进目标项目，或粘贴到 Claude Code 的项目说明里。保留 SKILL.md 作为完整工作流。

Hermes 和通用 AI

把 HERMES.md 或 SKILL.md 作为系统提示词或项目提示词。支持 repo instructions 的 agent 可以读取 AGENTS.md。

快速提示词

使用 multi-agent-handoff-coding 工作流。请先阅读当前项目文档和相关代码，再完成这个任务：做最小安全修改，运行必要验证，更新项目记忆和交接文档，公开输出前检查隐私信息，最后总结修改内容、验证结果和剩余风险。

内置模板

assets/templates/ 里提供了可复制到项目中的基础模板：

• PROJECT.md
• HANDOFF.md
• MEMORY_UPDATES.md
• CHANGELOG_AI.md
• TASK_BRIEF.md

隐私扫描

发布公开文档或交接材料前运行：

python3 scripts/privacy_scan.py README.md SKILL.md AGENTS.md CLAUDE.md HERMES.md references assets/templates

它会报告可能的本地路径、邮箱、私钥和 token 风险。它是护栏，不替代人工复查。

English

A portable AI coding skill for projects that move between agents, models, and sessions.

It teaches an AI coding agent to finish work as a closed loop: read the project, make scoped changes, verify results, update durable project memory, and leave a clean handoff for the next agent.

What This Skill Is For

• Long-running AI-assisted software projects.
• Codebases maintained by more than one AI agent or model.
• Projects where context loss, stale docs, or unverified changes are recurring risks.
• Public or shared work that needs privacy-safe summaries and READMEs.
• Teams that want AI outputs to be reusable by Codex, Claude Code, Hermes, and generic coding agents.

Core Behavior

An agent using this skill should:

• Read existing project docs and code before editing.
• Preserve unrelated user or teammate changes.
• Prefer small, idiomatic changes over broad rewrites.
• Run validation proportional to the risk of the change.
• Update project memory and handoff files as part of the definition of done.
• Scan public-facing output for private paths, emails, secrets, and internal details.

Quick Prompt

Use the multi-agent-handoff-coding skill. Complete this coding task end to end: inspect current project docs and code, implement the smallest safe change, run appropriate validation, update project memory and handoff docs, scan public output for private information, and summarize changes, verification, and remaining risk.

License

MIT