skill-maintenance
创建、审计、修正、拆分、升级、迁移或退役 Skill,或其合同/入口已漂移时,先恢复行为、授权与预算,再同步正文、调用者、版本、生成物和验证。普通业务维护、纯格式修正、承载位置未定的纠正不触发。Use for explicit Skill maintenance, not carrier choice.
- License 许可
- MIT
- 最近更新
- 2026-08-25
- Stars
- ★ 1
- Forks
- 2
01 前言 Front Matter
- name
- skill-maintenance
- description
- 创建、审计、修正、拆分、升级、迁移或退役 Skill,或其合同/入口已漂移时,先恢复行为、授权与预算,再同步正文、调用者、版本、生成物和验证。普通业务维护、纯格式修正、承载位置未定的纠正不触发。Use for explicit Skill maintenance, not carrier choice.
02 资源文件 1
- 参考文档agents/openai.yaml163 B
03 SKILL.md 正文
Skill 维护
只维护已确定由 Skill 承载的行为;不扩权、不降门、不造第二控制器。
进入与合同
进入:明确维护请求;或触发/跳过、步骤、硬门、退出、来源、调用者、版本、生成物、发现入口、符合性已有漂移证据。
不进入:普通业务代码、产品文档、非 Skill 测试;不改发布身份或行为的错字/格式(但已发布字节的现行版本规则仍服从);承载位置未定的纠正返回 self-improvement,不替它决定。
问题证据不授权写入、发布、安装、退役;缺授权只读并返回缺口。编辑前绑定:原始行为与可观察成功;触发/输入/步骤/输出/退出;授权、同意、写入所有权、证据等级;生命周期驱动者与本 Skill 角色;证据上限。
盘点主 SKILL.md、按需 references、全部调用/返回/reference 边、人类入口、双端 manifest/Marketplace、生成物及唯一命令、版本/生命周期/预算/符合性/发布退役工具;获授权才查安装端。未知就标未知,不从旧仓、旧 Issue 或记忆猜。
归型与设计
主类型:轻量文本、行为修正、结构重构、新能力、迁移/重命名、退役。新能力查净价值、误触发、预算、发现入口;迁移要求所有调用者 clean cutover;退役要求无入边、负责人批准、精确卸载回读。实验通过不等于发布或长期证据。
新增/扩张前计算 Skill 数与 SKILL.md+references 总字节。默认增加伴随压缩/合并/退役,不以搬 reference、拆 Plugin 或改单文件门洗白。只有负责人显式决定可以提高数量或字节上限;须有稳定记录且只到本次需要,提高一次不授权下一次继续提高。
主 SKILL.md 只放共用控制面;reference 仅命中时加载,主文件写命中、读取、返回。一个行为一个正文;调用者只路由;reference 不成为第二个控制器、生命周期驱动者或状态库;路径可定位;人类总览由生成物承载。
场景、切换与验证
行为修正、结构重构、新能力、迁移、退役须在编辑前预注册进入、分支/加载、硬门、退出/返回、证据上限;重构以同场景比较基线/候选。授权、明示同意、写入所有权、安全、不可逆动作、证据等级、角色下限是零回退门;漏一项即失败,不能用字节/行数减少或模型多数通过抵消。
实施:先改唯一正文,迁移全部调用者;删除旧路径、章节号、重复段落、别名、兼容壳、过期 re-export;生成物只运行唯一生成命令;已发布内容按生命周期规则递增版本,并同步 manifest、Marketplace、注册表、版本夹具、人类总览;发布、安装、指纹、退役只用已有工具。
先跑最窄检查,再跑完整符合性;行为变化跑预注册场景,部署主张跑真实入口。文本断言只证合同存在;探针记录模型/上下文/样本边界。新 Skill、跨 Skill 迁移、控制器拆分、退役、安全门、发布须独立审查;审查者必须与方案和实施者不同。blocker 要修源头、增加永久防线并重验。
返回
返回类型/目标、行为变化、预算与例外、迁移/删除/未知入口、运行/未运行/失败/证据边界、独立审查、下一责任人与动作。只返回段结果,不决定 Issue/PR/父目标生命周期;退出。
04 同仓库更多 Skills
skill-appraisal
判定一个 Skill 组该不该进当前装配、归哪些事项、与谁重叠,或对已判定过的组按节拍复核。三种进入:首次判定新候选、补判早已在用但从未判定过的组、按失效条件复核。判定单位是组不是单个 Skill;产出必须留下失效条件与下次最少复核步骤。用于外部来源、他人所写、疑似重复或从未被判定过的组。从零设计新 Skill 用 agent-skill-design;已定下后的改造、迁移、退役用 skill-maintenance;只要外部标准与版本事实用 capability-lifecycle;对象是 knowledge 用 knowledge-maintenance。本 Skill 只产出判定,不安装、不写配置、不改 profile。Appraise a Skill group, or recheck an adopted one. Judgement only, never installs.
self-improvement
当用户指出 Agent 漂移、误解、重复犯错,要求把任务经验固化为系统改进,或讨论只增概念却不减关键未知、形成决定或可检验资产时,只暂停依赖被推翻假设的路径,重锚原问题、持久记录纠正、诊断原因,并在授权内改进入口提示词或 Skill。最小实验不能验收产品交付;普通一次性错误、偏好或任务内修复不触发完整自我优化。Use for reported drift, misunderstanding, repeated mistakes, durable Agent improvement, or abstraction loops without decisions or testable assets. Freeze only affected paths and avoid a full detour for ordinary one-off corrections.
resource-observability
当用户查询 Codex/Claude 账户额度、重置时间、Codex 重置券、单 Session Token,或高成本/多 Agent 工作要决定启动、并行、降级、延后或停止时,按需读取 Orca 账户快照与固定 ccusage 回执,区分状态、来源、可信度和未知值。不要用于低风险任务、轮询、自动调度/消费权益、账单推断或长期保存快照。Use for account capacity, reset times, credits, session tokens, or consequential resource decisions. Skip routine work, polling, scheduling, automatic credit use, billing inference, and durable snapshot storage.
orchestrated-collaboration
当用户明确要求多 Agent/多 Session/跨 Provider 协作、任务已授权委派,或活动 Session 发生共享写入碰撞时,建立目标来源、排他所有权、可追踪交付、独立验收与综合;按共享资源和 Issue 子树确定唯一协调者,只冻结重叠或受推翻假设影响的路径。协调者参与高价值多交付件能力的拆分或设计时,由未参与者复核父目标;使用已选后端,选 Orca 时动态读 orchestration 指南。不要因复杂、额度或空闲 Agent 擅自并行,也不把试用变成长期依赖。Use for authorized multi-agent work, cross-session delegation, or shared-write collisions. Establish exclusive ownership, traceable delivery, independent acceptance, and bounded synthesis; add parent-goal review when required and avoid invented coordination or permanent platform commitments.
knowledge-maintenance
用于多来源调研、可重复实验、会影响权威/Agent 配置/重要决定的研究,或用户要求复用、复核、更新当前知识时:先找已认可知识和失效条件,只补变化、冲突与缺口,再经价值门和可信门更新。不用于低成本一次性事实、原始材料/研发过程留存、私域结构设计、定时全量重查或旧仓导入。Use before multi-source research, repeatable experiments, consequential authority/configuration decisions, or explicit knowledge reuse. Skip cheap one-off facts, raw retention, private architecture, scheduled full re-research, and bulk legacy imports.
grilling
仅在用户直接要求 grilling/盘问/压力测试,或明确接受建议后,用结构化问题压力测试计划、决定或想法;复杂性、关键词或 Agent 偏好不构成同意。Use structured questions to stress-test a plan, decision, or idea only on direct request or explicit acceptance; complexity or keywords are not consent.