AGENT SKILL

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.

License 许可
MIT
最近更新
2026-08-25
Stars
★ 1
Forks
2

01 前言 Front Matter

name
skill-appraisal
description
判定一个 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.

02 资源文件 1

03 SKILL.md 正文

Skill 组鉴别

判定一个组的去留与归属,并让下一次复核比这一次便宜。只产出判定和证据;执行由别的承载面负责。

进入与不进入

三种进入,先判定是哪一种,走的路径不同:

进入 触发 路径
首次判定 手上有候选组,要决定收不收 门 0 → 门 1–4 全跑
补判 组早已在用,但从未被判定过——没有失效条件、没有复核依据 门 0 → 门 1–4 全跑,处置受"它已在用"约束
复核 已判定过的组到了节拍,或失效条件命中 只重跑被命中的门,见「复核」一节

补判是现实里最常见的一种,不要当成首次判定。 差别在处置:首次判定可以简单地"不收",补判不能——它已经在装配里,正在被使用,还可能有别的组依赖它。补判的合法结论只有:维持、改造、改装配声明、退役并迁移调用者。「不收」对补判不是合法结论。

不进入:从零设计新 Skill(agent-skill-design);已定下后的改造、拆分、迁移、退役(skill-maintenance);只需要外部标准、版本或客户端兼容性事实(capability-lifecycle);对象是 knowledge 而非 Skill(knowledge-maintenance)。

判定单位是组,不是单个 Skill。 拿到孤立的 Skill 时先定它属于哪个组;定不出组就先定组边界,不得跳过这一步直接判定单个 Skill——那会把成员从组里拆出来,而组内通常互相调用。

候选存在、已被安装、来源流行或作者可信,都不构成留下的理由。未读过组内正文不得给出判定;只读 README 或 description 不算读过。成员很多时读到能回答全部门为止,并写明读了哪些、没读哪些。

门 0 · 来源与可改动性

先于其余各门。 不知道一个组能不能改,就说不清后面任何一门的处置空间——判定完才发现改不了,等于白判。

来源三分,判据是允不允许本地改动:own 自写,可改;fork 拿来直接用并承诺零改动,不可改;vendor 拿来但打了补丁,改动须逐条登记且升级时要重打。

判 fork 必须给出可机械验证的依据:上游位置、pin 到的 ref、一条能重跑的比对步骤。给不出就不能记 fork,记 vendor 或标未知;不允许名义 fork、实际改过——那种改动下次升级一定丢失且无人知晓。

同时记下该组是否依赖外部工具版本。来源类型与外部依赖是两回事:一个 own 组也可以锁在某个外部 CLI 版本上,那是它的失效条件之一。

本门的产出直接约束后面各门的处置:fork 组的任何问题都不能靠改它的正文解决,只能靠装配声明、外置或退役。

门 1 · 组边界

写出候选组的成员清单,以及成员之间的引用、路由与转发关系。存在互相调用即不得按成员拆分——拆组会拆断。

拆不开又跨越互斥职责的候选,只有两种合法结论:它本来就是一个大方法包(记录它跨哪些事项,进门 2),或者它耦合过度不该收。不得为了让它"归类干净"而先拆再判。

门 2 · 事项归属

写出候选组服务的事项,可以多个。指不到任何已存在事项时只有两种合法结论:这是一个新事项,需负责人裁决后才继续;或者候选不该存在。不得用「通用」「都能用」「以后可能有用」充当归属。

同时写出该事项当前已有哪些组——门 3 要用。

门 3 · 重叠与净增量

列出候选组在目标事项内、以及跨事项的最近邻组,逐个说明差异。差异必须用「它替谁做了哪个决定」表述,不得用篇幅、成员数、结构、写法或新鲜度充当净增量。

三种结局:

  • 真空缺:无最近邻覆盖该决定,进入门 4。

  • 完全重叠:不收(首次判定)或退役并迁移调用者(补判),返回已覆盖它的组。

  • 部分重叠:先分清是哪一种,两者处置完全不同——

    • 同层重叠:两个组替同一个人做同一个决定。不得并存,必须退役其一或改造其一。
    • 跨层重叠:一个决定「用不用、什么时候停」,另一个决定「具体怎么做」。这不是冗余,是分层;正确处置是把分界写进双方的 description 与正文,不是退役。判错这一点会砍掉本该配合的能力。

本门同样适用于往已有的组里加东西:加之前先查同一个组内是否已有该能力,查不到才加。往组里塞重复能力与收下一个重复组是同一类错误,且更难被发现。

门 4 · 路由

description 是唯一路由面,按它单独判定,不参考正文补足。对组内每个成员检查是否同时写明:正向触发、不适用边界、与相邻 Skill 的职责分界。三者缺一即该成员不通过;组内有成员不通过则整组不通过。

误触发的成本高于漏触发:一个在错误时机加载的 Skill 是负资产。写不出「什么时候不该用我」的候选直接不收,不得由鉴别方替它补写后再判定通过——补写是定下之后 skill-maintenance 的工作。

同时检查正文是否越过 description 声明的边界,以及是否在正文里安置了第二个控制器、生命周期驱动者或状态库。

处置:优先落在装配层

装配是绝对权威:每个装配显式声明它要哪些 Skill,没声明的就不存在。这是白名单,不是黑名单——黑名单只排除已知的坏的,上游下次新增就自动漏进来。

由此得出处置的优先顺序:

  1. 改装配声明——两个组各自都合理、只是不该同时出现在同一个装配里时,让该装配只声明其中一个。这是首选:不改任何正文,不动 fork,也不废掉另一个装配里的合法用法。
  2. 补边界——把分界写进 own 组的 description 与正文。只能改 own;fork 不可改。
  3. 改造后收 / 迁移——交给 skill-maintenance。
  4. 退役——最后手段。退役会把所有装配里的它一起废掉,跨装配影响必须先写清。

不要因为资产面上有重叠就退役。 资产面登记的是仓库里有什么,装配面决定的是某次运行里有什么;重叠只有在同一个装配内同时出现才是问题。

复核:不是重判

已判定过的组到节拍时走本节,不重跑各门。

  1. 取上次判定留下的失效条件与下次最少复核步骤,先按最少步骤确认结论是否仍成立。
  2. 只重跑被失效条件命中的那道门;其余门沿用上次结论,并注明沿用来源与上次判定时间。
  3. 沿用依据本身已失效、或最少复核步骤跑不通时,才退回完整重判,并写明为什么退回。
  4. 复核后刷新上次复核时间;结论有变的,同时更新失效条件与最少复核步骤。

外来组的失效条件挂在组上,不挂在成员上:上游发布新版是全组共享的唯一失效条件,写一次,不是逐个成员写。

无法用最少步骤确认的结论立即退出当前认知,重新核验前只能作历史证据,不得因为已经写下就继续引用。

预算

给出候选组的成员数、description 字节、主合同字节、按需 references 字节,以及变化量。

新增默认伴随抵消:指出被压缩、合并或退役的对象。给不出抵消时,把「需要提高上限」作为一项负责人裁决返回,不得自行通过;不得用搬运 reference、拆分组、改动承载路径洗白增量——换个目录不减少任何运行成本,只是让门失效。

按资产数量设的上限拦不到运行成本,因为资产数量不等于装配数量。真正按运行成本计的是每项 description 的可见字节预算,它逐项生效且与资产总数无关。

返回

  • 进入类型:首次判定 / 补判 / 复核。
  • 判定:维持 / 收 / 改造后收 / 改装配声明 / 退役 / 不收 / 需负责人裁决;附不通过的门。补判不得返回「不收」。
  • 来源:own / fork / vendor,附上游位置、ref、许可证、逐条本地改动、更新触发与外部依赖版本。
  • 组边界:成员清单与内部引用关系;跨事项时说明为什么不拆。
  • 归属:服务的事项,可多个。
  • 重叠:最近邻组、是同层还是跨层、以及依据。
  • 处置:按装配层优先的顺序给出;涉及退役时写清跨装配影响。
  • 触发分类:new-scenario 出现新事项/known-insufficiency 已知能力不足/bad-case 已发生的失败,三选一。
  • 证据:读过的正文范围、未读部分、仍未知的边界。
  • 预算:字节与数量变化及抵消,或待裁决的上限提高。
  • 失效条件:这个判定在什么情况下不再成立。
  • 下次最少复核步骤:怎么用最小代价确认它还成立。

最后两项不可省。 不写它们的判定等于制造一个下次必须从零重做的负担,本 Skill 的全部价值就在于消除那个负担。

判定不授权安装、写入配置或修改 profile。「改装配声明」交给装配路径执行,「改造后收」与「退役」交给 skill-maintenance,「需负责人裁决」停在此处等待。返回后退出,不代为决定事项的存废。

04 同仓库更多 Skills

zaurakworks
zaurakworks/agent-system

skill-maintenance

创建、审计、修正、拆分、升级、迁移或退役 Skill,或其合同/入口已漂移时,先恢复行为、授权与预算,再同步正文、调用者、版本、生成物和验证。普通业务维护、纯格式修正、承载位置未定的纠正不触发。Use for explicit Skill maintenance, not carrier choice.

★ 1
zaurakworks
zaurakworks/agent-system

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.

★ 1
zaurakworks
zaurakworks/agent-system

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.

★ 1
zaurakworks
zaurakworks/agent-system

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.

★ 1
zaurakworks
zaurakworks/agent-system

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.

★ 1
zaurakworks
zaurakworks/agent-system

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.

★ 1