Skill Engineering Review

持续拆解高工程化 Agent Skills 的证据化评审仓库。

本仓库从 Skillware Engineering 论文的 14 个固定版本案例出发，建立一条可持续推进的明星 Skill Review 队列。每次只研究一个案例，先锁定评估边界和版本，再追踪入口、资源、脚本、Host 集成、验证与生命周期，最后沉淀可复用的工程判断。

flowchart LR
    A["Skillware 固定案例"] --> B["工程化优先目录"]
    B --> C["单案例证据审阅"]
    C --> D["可复用模式与反模式"]
    D --> B

Loading

Skillware GoF 地图

本图将已完成 Review 中具有源码协作证据的模式放回 GoF 23 模式体系。节点中的项目编号链接到下方 Review；空节点表示当前尚无高置信度案例。近似实现和中低置信度判断只保留在单项目 Review，不进入总图。

flowchart TB
    subgraph CREATIONAL["创建型模式 · Creational"]
        direction TB
        AF["Abstract Factory<br/>—"] ~~~ BLD["Builder<br/>R001 · larksuite/cli"] ~~~ FM["Factory Method<br/>—"] ~~~ PROTO["Prototype<br/>—"] ~~~ SINGLE["Singleton<br/>—"]
    end

    subgraph STRUCTURAL["结构型模式 · Structural"]
        direction TB
        ADAPTER["Adapter<br/>R001 · larksuite/cli"] ~~~ BRIDGE["Bridge<br/>—"] ~~~ COMPOSITE["Composite<br/>R001 · larksuite/cli"] ~~~ DECORATOR["Decorator<br/>R001 · larksuite/cli"] ~~~ FACADE["Facade<br/>R001 · larksuite/cli"] ~~~ FLYWEIGHT["Flyweight<br/>—"] ~~~ PROXY["Proxy<br/>R001 · larksuite/cli"]
    end

    subgraph BEHAVIORAL["行为型模式 · Behavioral"]
        direction TB
        COR["Chain of Responsibility<br/>R001 · larksuite/cli"] ~~~ COMMAND["Command<br/>R001 · larksuite/cli"] ~~~ INTERPRETER["Interpreter<br/>—"] ~~~ ITERATOR["Iterator<br/>—"] ~~~ MEDIATOR["Mediator<br/>—"] ~~~ MEMENTO["Memento<br/>—"] ~~~ OBSERVER["Observer<br/>R001 · larksuite/cli"] ~~~ STATE["State<br/>—"] ~~~ STRATEGY["Strategy<br/>R001 · larksuite/cli"] ~~~ TEMPLATE["Template Method<br/>—"] ~~~ VISITOR["Visitor<br/>—"]
    end

    classDef mapped fill:#dcfce7,stroke:#15803d,color:#14532d,stroke-width:2px;
    classDef empty fill:#f3f4f6,stroke:#9ca3af,color:#6b7280;
    class BLD,ADAPTER,COMPOSITE,DECORATOR,FACADE,PROXY,COR,COMMAND,OBSERVER,STRATEGY mapped;
    class AF,FM,PROTO,SINGLE,BRIDGE,FLYWEIGHT,INTERPRETER,ITERATOR,MEDIATOR,MEMENTO,STATE,TEMPLATE,VISITOR empty;

Loading

• R001：larksuite/cli Agent Skills Suite

当前覆盖：1 个固定版本项目，10 / 23 个 GoF 模式拥有至少一个高置信度案例。

入图规则

1. 项目必须已有完成状态的固定版本 Review。
2. 模式必须能指出 Context、参与者、协作过程和可替换点。
3. 模式名称、构造函数、枚举或单次 switch 不能单独构成证据。
4. 同一实现符合多个模式时，分别说明各自解决的变化方向，避免重复贴标签。
5. README 只收录高置信度结论；候选模式留在项目 Review 等待补证。

开始 Review

1. 从 CATALOG.md 选择队列中第一个待评审案例。

2. 复制统一模板并锁定上游 commit：

   cp reviews/_TEMPLATE.md reviews/001-superpowers.md

3. 完成证据核验，更新目录状态，提交本次 Review。

4. 将高置信度 GoF 模式同步到本页地图。

仓库结构

.
├── README.md
├── CATALOG.md
├── AGENTS.md
└── reviews/
    ├── _TEMPLATE.md
    └── R001-larksuite-cli.md

• CATALOG.md：候选 Skill、固定版本、审阅顺序和当前状态。
• reviews/：已启动或已完成的单案例 Review。
• AGENTS.md：统一研究边界、证据纪律和验收标准。

已完成 Review

• R001：larksuite/cli Agent Skills Suite — 薄 Skill 决策层、确定性 CLI 内核、安全与质量治理闭环。

研究原则

• 结构形态不代表质量等级；评审顺序是本仓库的工程判断。
• 每个事实必须绑定上游 commit、具体路径或可复现实验。
• 明确区分事实、判断、假设、推断和建议。
• 先审控制链和生命周期，再进入单个 SKILL.md 的文案细节。
• 只保存链接、少量合规引用和原创分析，不镜像第三方 Skill 内容。

维护者

Anthony Fan

License

MIT — see LICENSE.