name: zfl-skill-creator
slug: zfl-skill-creator
tags:
- 技能创建
- 技能脚手架
- 生成技能
- 技能初始化
displayName: "技能质量创建器"
cn_name: "技能质量创建器"
summary: 张总的自建技能创建向导:覆盖创建→评审→合规→协作→分享完整生命周期,自动 zfl- 前缀+专家评审
version: 2.0.27
license: Apache-2.0
layer: L4
layer_name: Orchestrate
trigger: >-
创建技能、新建技能、新建skill、create skill、新建zfl技能、做个新技能、生成技能模板、帮我建个技能、skill创建、新建一个技能、封装成技能、写一个技能、分享技能、检查技能冲突
触发场景: >-
当用户需要创建新的 WorkBuddy 技能(编写SKILL.md、生成脚本模板、配置frontmatter)时使用本技能。
创建技能、新建技能、新建skill、create skill、新建zfl技能、做个新技能、生成技能模板、帮我建个技能、skill创建、新建一个技能、封装成技能、写一个技能、分享技能、检查技能冲突。
不适用:(1)非zfl前缀技能的创建(本技能创建的均为zfl-前缀技能);(2)技能内容的生产环境部署(应由 zfl-sync-suite 处理)。
调用链(Call Chain)
本技能为工具型编排层,不直接调用L1/L2/L3技能,
而是引导用户完成技能创建的全流程(命名→编写→评审→导出)。
创建完成后,可能触发:
- zfl-expert-review(专家评审)
- zfl-skill-syncer(导出/同步)
- zfl-skill-self-test(脚本类技能可选搭回归冒烟自检)
但本技能本身不调度这些技能,仅输出技能模板。
call_chain:
- step: 1
layer: L4
skill: "(本技能)"
purpose: "引导用户完成技能命名(自动添加zfl-前缀)"
- step: 2
layer: L4
skill: "(本技能)"
purpose: "生成SKILL.md模板(含触发场景、层级标签、调用链标注)"
- step: 3
layer: L4
skill: "(本技能)"
purpose: "触发zfl-expert-review进行专家评审(可选)"
- step: 4
layer: L4
skill: "(本技能)"
purpose: "输出技能文件,提示使用zfl-skill-syncer导出/同步"
注:本技能为"工具型L4",不串联L1/L2/L3,
但创建的技能可能属于L1/L2/L3/L4任意层级。
created_skill_layers: ["L1", "L2", "L3", "L4"]
description: >-
张总的自建技能创建向导。
agent_created: true
success_metrics:
install_success_rate: ">95%"
feedback_response_time: "<24h"
self_check_pass_rate: ">90%"
iteration_frequency: "weekly"
workflow:
stages:
- name: "Discovery"
description: "理解用户需求、判断技能类型"
required: true
- name: "Planning"
description: "生成 SKILL.md 模板、确定工作流结构"
required: false
- name: "Execution"
description: "创建技能目录、写入文件、注入规则"
required: true
- name: "Review"
description: "自检输出内容、确认触发词覆盖、输出创建报告"
required: true
- name: "Verify"
description: "完整性验证、健壮性检查、质量评分确认"
required: true
打包依赖清单(打包时自动附带以下技能)
package_dependencies:
- name: zfl-skill-quality-checker
version: "1.11.41"
purpose: "工作流步骤1:质量检查(解析 _catalog.json 获取真实质量分+缺失要素+外部引用验证+打包预检+形式问题分类)"
- name: zfl-skill-debug-guide
version: "1.5.2"
purpose: "工作流步骤2:调试技能(条件触发,质量分 < 80 时)"
- name: zfl-skill-syncer
version: "2.2.8"
purpose: "工作流步骤4:同步技能(跨电脑同步、打包导出、知识库推送、排除规则与预检)"
- name: zfl-expert-review
version: "0.9.0"
purpose: "工作流步骤3:专家评审(5角色评分+打包预检审查+外部数据验核+YAML格式一致性审查)"
- name: zfl-skill-self-test
version: "1.2.3"
purpose: "(可选)为脚本类新建技能搭建回归冒烟自检:调用其 gen_smoke.py 自动探测主脚本/demo/产物名并生成 tests/smoke_test.py,含负向验证门禁"
metadata:
author: zfl
version: "2.0.27"
disable-model-invocation: false
> 族内入口声明(技能质量管理族 · 创建段)
> 本技能为技能创建薄壳入口(2026-09-26 族谱决策):路由层承接「创建技能/新建技能/生成技能模板」类触发,
> 实现真源在 zfl-skill-factory/sub-skills/01_creator/(技能创建逻辑以 factory 为准)。
> 本目录为 legacy 备份(见 _LEGACY.md),scripts/ 为冻结快照,请勿直接修改;
> 任何技能创建逻辑变更一律走 factory,勿在本目录新增实现。
约束与错误处理
- 本技能是薄壳入口:只做意图识别与转发,技能创建流程与判定一律以
zfl-skill-factory/sub-skills/01_creator/module.md为准;本目录 scripts/ 为冻结快照,禁止直接修改(防第二份活体实现再生)。 - 依赖 factory / quality-checker / expert-review / syncer 在位且版本兼容;任一缺失时显式降级提示,不静默假装可创建。
- 不越界:非技能创建类需求(技能退役/吸收、发布到 SkillHub、批量管理)转交对应专才技能,不在本入口重复实现。
参考文档
zfl-skill-factory/sub-skills/01_creator/module.md:技能创建真源(Stage 0 需求质询门 → 命名 → 编写 → 评审 → 导出)zfl-common/references/skill_contract_model.md:Skill 五层合同模型(编写元规范,grep: 合同模型/五层)zfl-common/references/add-shared-script-sop.md:共享脚本接入与消费定级(grep: 三级判据/L1→L2)references/FAQ.md:常见错误场景处理 + 反模式避坑(依赖缺失/非创建需求转交/冻结快照纪律/五源版本一致性)- 触发后按以上真源执行;本目录不维护实现副本(PF-536 单一真源)。
示例(薄壳入口转发演示)
用户:「帮我建个技能」/「新建 skill」→ 本入口识别触发词后,按真源流程执行:
1. Stage 0 需求质询门:重大/模糊需求先 grill(≤8 问,达成「该不该建/建成什么样」共识);轻量/明确需求直接跳过。
2. 命名:自动 zfl- 前缀 + 冲突检测(触发词打架即提示)。
3. 骨架生成:产出 SKILL.md 模板 + scripts 模板(按 01_creator/module.md 契约)。
4. 质量门:调 zfl-skill-quality-checker 复扫(目标 P0=0)+ 可选 zfl-expert-review 专家评审。
5. 导出:zfl-skill-syncer 同步/打包(不适用场景:非 zfl- 前缀技能、生产环境部署)。
实际命令形态(薄壳入口 → 真源,<skills_root> 为技能根目录占位符):
# 1) 查看真源创建流程(Stage 0 质询门 → 命名 → 编写 → 评审 → 导出)
type <skills_root>/zfl-skill-factory/sub-skills/01_creator/module.md
# 2) 骨架产出后跑质量门(P0=0 才放行,依赖 quality-checker)
python <skills_root>/zfl-skill-quality-checker/scripts/quality_checker.py --skill-dir <新技能目录> --fail-on P0
自检与成功标准
- 成功标准:意图识别正确(技能创建类触发命中本入口);转发完整(按 01_creator 全流程执行,无静默跳步);骨架产物通过 quality-checker 复扫(P0=0)。
- 输出前自检:确认未在本目录 scripts/ 产生任何改动(冻结纪律);确认依赖技能版本兼容;确认未越界承接非创建类需求。