| name | skill-co-learn |
| description | 用于在检测到高价值开发经验、功能模式、设计最佳实践，或用户明确要求“记住这个”“提炼Skill”“让其他Agent也学会”时，提炼可直接落盘的共享 Skill 文件，并在全局/项目级 Scope 之间做智能判断与路径适配。适用于 /skill-co-learn、/skill-colearn，以及相关中文触发语境。 |
Skill Co Learn
将高价值经验转化为可直接落盘的 Skill 文件，并在三体 Agent 间实现低成本同步。
使命
- 把高价值经验从一次性对话转成可落盘的 Skill 文件
- 让
claude code、codex、antigravity 共享同一套最佳实践
- 根据用户选择的 Scope 自动适配全局路径或项目路径
- 优先沉淀功能实现、代码模式、UI/UX 流程和产品方法论
触发条件
每轮对话都检查是否命中以下任一条件。
显式触发
- 用户输入
/skill-co-learn
- 用户输入
/skill-colearn
- 用户说出类似表达：
- “刚刚这个经验你应该记住它”
- “记住这个”
- “提炼Skill”
- “让其他Agent也学会”
- “保存成skill”
自动触发
仅在高价值且高置信度时自动触发：
- 同一功能或设计迭代达到 3 次及以上
- 且用户明确表示满意，如“完美”“满意了”“太棒了”
接收外部 Skill
如果用户粘贴其他 Agent 生成的完整 SKILL SHARE BLOCK，进入“接收新 Skill”分支，而不是重新提炼。
执行流程
严格执行以下 7 步。
1. 进入共学模式
一旦命中触发条件，先输出：
✅ 检测到高价值经验，正在用当前上下文润色并准备Scope判断...
2. 上下文深度分析
回顾对话并提炼：
- 当前问题
- 迭代过程
- 最优方案
- 为什么有效
- 可复用的场景
- 可补充的衍生应用想法
3. 苏格拉底共创提问
只在必要时提问，最多 2 个精准问题，用于快速拉齐：
4. Scope 判断（必须执行）
无论上下文是否充分，都必须问出这句：
这个Skill是需要全局使用（永久学会，所有项目都可用）还是只需要当前单个项目使用（三个Agent同时学会，仅本项目生效）？
在用户明确回答 Scope 之前，不进入最终路径落盘判断。
5. 主动润色增强
根据用户选择的 Scope：
- 优化 Skill 文案
- 优化三体角色适配
- 选择正确的安装路径模板
- 补充当前上下文中最值得保留的增强点
6. 输出标准化 Skill 草案
生成轻量版标准 Skill 草案，并动态插入 Scope 和路径。
标准输出模板
严格使用以下结构：
**Skill: [kebab-case-英文名]（中文名称）**
**用途**：一句话价值描述
**触发条件**：
**核心流程**：3-5步
**三体角色适配**：
- claude code & codex：
- antigravity：
**增强点**（当前上下文补充）：
**Scope**：全局 / 项目级（根据用户回答填写）
**安装路径（已根据Scope自动适配）**：
- claude code：~/.claude/skills/[kebab-name]/SKILL.md （全局） 或 ./.claude/skills/[kebab-name]/SKILL.md （项目级）
- codex：~/.codex/skills/[kebab-name]/SKILL.md （全局） 或 ./.agents/skills/[kebab-name]/SKILL.md （项目级）
- antigravity：~/.gemini/antigravity/skills/[kebab-name]/SKILL.md （全局） 或 ./.agent/skills/[kebab-name]/SKILL.md （项目级）
**版本**：v1.0
路径适配规则
全局 Scope
claude code：~/.claude/skills/[kebab-name]/SKILL.mdcodex：~/.codex/skills/[kebab-name]/SKILL.mdantigravity：~/.gemini/antigravity/skills/[kebab-name]/SKILL.md
项目级 Scope
- 统一放在
skills/[kebab-name]/SKILL.md
- 同时注册到项目根目录的
SKILL_REGISTRY.md
输出时必须根据用户选择，仅将 Scope 说明写成对应结论，但路径模板两组都要展示，方便同步。
三体角色适配
claude code：偏架构、规则沉淀、代码审查、系统性方法抽象codex：偏代码实现、流程提炼、功能落地、模式归纳antigravity：偏 UI/UX、视觉模式、交互流程、体验优化方法
提炼 Skill 时，明确说明三者如何复用同一经验，而不是只写单一角色视角。
接收外部 Skill 时的响应
如果用户粘贴完整的 SKILL SHARE BLOCK：
- 立即回复：
确认！我已将 [Skill名称] 永久加入我的知识库。从现在起，无论哪个Agent触发对应条件，我都会自动应用这个最佳实践。
- 之后在后续对话中遵守该 Skill 的步骤与适配规则
如果共享块不完整：
- 说明块不完整，要求用户补充完整的
SKILL SHARE BLOCK
- 不要在块不完整时宣称已经学会
自动触发边界
- 不要在普通闲聊或低价值小修中滥用
- 只有在“高价值经验已稳定成型”时才自动触发
- 如果当前任务仍在关键实现中，优先完成当前关键问题，再进入共学提炼
最佳实践
- 优先提炼服务于“高效做出好产品”的经验
- 优先从功能、架构、UI、协作流程里提炼
- 保持 Skill 简洁、可执行、可被其他 Agent 直接复用
- 如果发现更好版本，使用
/skill-colearn 更新 [旧Skill名] 迭代，而不是创建冲突 Skill
- 如果用户没有给出 Scope，不要跳过提问，必须先完成 Scope 判断
7. 落盘与注册
如果是项目级 Scope
且项目中存在 SKILL_REGISTRY.md：
- 写入
skills/[kebab-name]/SKILL.md
- 将新技能追加到
SKILL_REGISTRY.md 的技能总览表格中
- 同步更新
CLAUDE_PROJECT_MEMORY.md 的"最近重要变更"
如果是全局 Scope（一键三写）
必须依次写入以下三个路径，确保三体 Agent 同时学会：
- Claude Code：写入
~/.claude/commands/[kebab-name].md（扁平 .md 文件，非目录）
- Codex：创建
~/.codex/skills/[kebab-name]/SKILL.md（目录 + SKILL.md）
- Antigravity：创建
~/.gemini/antigravity/skills/[kebab-name]/SKILL.md（目录 + SKILL.md）
三个路径全部写入后：
- 无需更新
SKILL_REGISTRY.md
- 建议更新
CLAUDE_PROJECT_MEMORY.md 记录新增的全局技能
