一个目标导向、窄腰结构的标准项目内核 Skill，也可以称为“基因胶囊”。
它帮助新的 Agent 在换窗口、换模型、换人或换环境后，快速恢复项目身份、关键边界、验收方式、稳定基准和当前接力状态；同时避免用厚重规则冻结实现。
minimal-skill负责识别复杂项目不可删除的核心关系：目标、边界、契约、证据和演化。maintenance-capsule负责把已经确认的项目核心保存到仓库本地，让新窗口、新模型或新维护者能恢复当前项目。
一句话：minimal-skill 找到项目内核，maintenance-capsule 把内核保存成可维护状态。
同一段提示词不能保证不同模型产生相同结果。稳定项目更可靠的方法是固定少量跨环境不变量：
目标 → 边界 → 验收证据 → 稳定基准 → 当前接力状态
实现路径仍由模型自主判断。新版本只要更接近目标、没有越过边界，并且能用真实证据证明改善，就可以升级。
init：为没有胶囊的仓库建立最小结构。audit：删除重复、过时和过度限制的项目规则。refresh：目标或稳定基准变化后，更新胶囊中的当前事实。resume：新窗口、模型、人员或阶段接手时，核验真实现场并从下一步最小动作继续。
默认只创建一个文件：
GOAL.md
GOAL.md 同时承担项目“身份证”和短接力棒。只有项目确有需要时才增加：
AGENTS.md：项目局部规则会实质改变决策或保护项目；HANDOFF.md：接力状态超过约 10–20 行、频繁变化或包含大量临时细节；- observable baseline：已有真实验收和回归比较价值。
不会为满足模板而生成目录蓝图、Changelog 或流程检查表。
一个最小胶囊默认只包含：
GOAL.md 项目身份、边界、验收证据、稳定基准和短接力状态
项目存在局部安全或执行规则时才加入 AGENTS.md；接力状态过长或频繁变化时才拆出 HANDOFF.md；baseline artifact 只有在它能显著改善验收时才加入。
示例见 examples/portfolio-site-capsule.md。它展示了一个个人网站仓库如何保存目标、数据来源、验收方式和自动同步边界，而不冻结 CSS、布局或实现细节。
git clone https://github.com/xiaogege6697/maintenance-capsule-skill.git \
~/.codex/skills/maintenance-capsule重新打开 Codex 会话后即可使用。
可以显式调用：
使用 $maintenance-capsule 为这个项目建立维护胶囊
使用 $maintenance-capsule 审计现有胶囊，删除过度约束
使用 $maintenance-capsule 核验当前状态并从上次中断处继续
也支持自然语言触发，例如：
- “保存这个项目，方便以后继续维护”
- “固定当前项目风格”
- “换窗口后还能稳定接着做”
- “给这个仓库做项目交接”
- “维护升级一下现有胶囊”
普通修 bug 或日常代码维护不会因为出现“维护”“固定”等单个词而误触发。
- 先检查真实仓库，再写胶囊。
- 固定目标与验收，不固定普通实现细节。
- 一轮只改变一个主要变量，避免无法判断效果来源。
- 用“改善 / 持平 / 退化 + 证据”比较版本，不使用无标尺数字评分。
- 优先删除不改变未来决策的规则。
- 不越过用户的覆盖、提交、推送、部署和删除边界。
本仓库的行为样例在 evals/evals.json。重点覆盖：
- 应触发：保存项目、跨窗口继续、仓库交接、胶囊刷新。
- 不应触发：普通 bug 修复、只出现“固定”一词的视觉任务。
- 核心质量：先检查真实仓库，不凭用户描述编造胶囊；审计时删除过度约束；刷新时替换旧事实而不是堆历史。
完整执行规范见 SKILL.md。