用途
laohan-skillcreator 用于创建、审计、修复和优化 Agent Skills。它把工作划分为五种互斥的主模式,每次只选一个:
- CREATE:新建一个可复用 Skill。
- AUDIT:体检、评分、检查合理性,只读诊断,不修改文件。
- SURGICAL_FIX:恢复原版、修正明确错误、更新固定合同或路径。
- OPTIMIZE:用户明确要求提升效果、比较新旧方案或全面演进。
- UPSTREAM_REFRESH:更新本 Skill 借鉴的方法或核验引用是否变化。
模式选择原则:用户说“改 Skill”但给出了明确错误或原版真源,默认 SURGICAL_FIX;只有用户要求“优化效果、全面审核、比较方案”才进入 OPTIMIZE。AUDIT 不隐含修复授权,CREATE 不隐含安装或发布授权。
主要能力
- 创建流程:先质疑意图(能否扩展现有 skill、能否不建),再捕获意图、调研、写 SKILL.md、测试迭代、本地验收。
- 审计流程:冻结被审计文件和问题,先找会改变触发、执行、效果或维护成本的问题,区分 BLOCKING、BEHAVIOR_RISK、MAINTENANCE 和 NO_ISSUE,输出结论与最小建议,不修改文件。
- 修复流程:只修改能追溯到该错误的行,运行针对性检查,不为小修复增加评分表、blind judge 或全量 trigger 矩阵。
- 优化流程:建立可比基线,一轮一个因果假设,独立验证与 held-out gate,棘轮轻量版,连续 2 轮无实质改善就停手。
- 上游更新:运行 scripts/check-upstreams.sh,读取 diff,只吸收能改善本地真实行为的变化,不自动覆盖本地方法。
使用方式
该技能以 SKILL.md 形式提供,包含 frontmatter(name + description,laohan-local profile 另要求 version)、核心理念、工作流、操作规则、不适用场景、反模式、输出格式等章节。它提供极简骨架和完整骨架两种模板,并给出 6 维快速评分卡(frontmatter 质量、工作流清晰度、失败模式编码、检查点设计、可执行具体性、反例与风险边界),满分 100。评分要求每个扣分必须引用 SKILL.md 具体行号或段落原文。
适用场景
适用于需要新建 Agent Skill、检查 Skill 质量、恢复原版或修正明确错误、比较新旧效果,或更新本 Skill 借鉴的上游方法时。触发词包括“创建skill”“写一个skill”“改skill”“优化skill”“给skill打分”“skill体检”等。
限制
不适用于创建 agent(agent ≠ skill)、非 SKILL.md/Agent Skills 兼容的平台插件、修改 npx 第三方 skill(需 fork 后新建),以及缺必要输入(用户说不清要做什么)的情况。该技能强调不编造、不猜测,缺输入时列出缺什么并停止。