name: zfl-skill-catalog
tags:
- 技能发现
- 有哪些技能
- 看看技能库
- 技能目录
- 浏览技能库
- 更新技能
slug: zfl-skill-catalog
displayName: "技能安装汇总"
cn_name: "技能安装汇总"
summary: 技能库浏览/发现与批量安装聚合器——列出已装技能、检查更新、一键安装所有技能；与 zfl-skill-factory（构建/发布）职责分离，靠 conflicts 字段避免触发冲突。
version: 1.1.1
license: Apache-2.0
layer: L3
layer_name: Orchestrate
conflicts:
- zfl-skill-factory
- zfl-skill-syncer
- zfl-sync-suite
- zfl-bidirectional-sync
- zfl-skill-installer
route_priority: 2
owns:
- 技能库浏览/发现
- 技能更新检查
- 一键安装所有技能
trigger: 技能发现, 有哪些技能, 看看技能库, 技能目录, 浏览技能库, 更新技能, 检查技能更新, 查看技能更新, 一键安装所有技能
触发场景: 当用户需要浏览技能库目录、查找可用技能、一键安装或批量管理技能时使用本技能 分享技能到技能库, 上传技能到技能库, 技能反馈, 技能回滚,
恢复技能版本, 智能巡检, 定时巡检, 新手三件套, 推荐技能, 按业务层查看技能, 业务矩阵, 现场作业技能, 项目管理技能, 商务支撑技能,
运维管理技能, 基础设施技能, ROI, 回本周期, 年省多少时间
trigger_scenario: 技能生态"应用商店"中枢，从本地固化 JSON 完成技能发现、同步、分享、反馈与恢复。 与其他技能的关键区别：主数据源为本地
skills_data.json（零 API 依赖），支持企微 zip 导出作为降级通道。
不适用：（1）跨电脑同步（zfl-skill-syncer）；（2）同步到乐享/IMA知识库（zfl-sync-suite）；（3）技能质量评审（zfl-skill-quality-checker）。
description: WorkBuddy 技能生态的应用商店中枢。主数据源为本地固化 JSON，支持企微 zip 导出降级通道，
完成技能的发现、同步、分享、反馈与恢复。零 API 依赖，安装即用，可跨设备分享。覆盖 6
个场景：技能发现、技能同步、技能分享、技能反馈、技能恢复、智能巡检。
sub_skills_layers:
L1:
- file-agent
- zfl-skill-installer
- zfl-skill-quality-checker
- zfl-skill-review
scripts:
- scripts/check_updates.py
- scripts/extract_smart_table.py
config:
- config.json
success_metrics:
install_success_rate: ">95%"
feedback_response_time: <24h
self_check_pass_rate: ">90%"
iteration_frequency: monthly
workflow:
stages:
- name: Discovery
description: 检查依赖技能、读取 skills_data.json（主）或企微 zip（降级）
required: true
- name: Planning
description: 生成差异报告、估算磁盘占用
required: false
- name: Execution
description: 调用 installer 安装技能包
required: true
- name: Review
description: 安装结果汇总、自检确认、输出报告
required: true
agent_created: true
author: zfl
metadata:
author: zfl
version: 1.1.1
changes_1.1: 去掉 skill_catalog.py 里 startswith("zfl-") 硬编码过滤，默认全量收录；无 layer/version 作 P2 提示而非过滤条件；新增 --zfl-only 开关保留前缀视图（元技能反噬修复：目录视图静默漏记非 zfl-* 技能导致 PM 家底视图失真）
changes_1.0: 初始化版本：本地固化 JSON 为主数据源，企微 zip 导出为降级通道，MD5 文件哈希精准检测更新
disable-model-invocation: true
dependencies: ["zfl-telecom-completion-audit", "zfl-common"]
<!-- AUTH_BOUNDARY -->
授权边界
本技能仅在自身定义范围内行动；任何超出本技能定义范围的操作（含发布、购买、安装依赖、修改账号、删除/破坏性操作）均须由你在独立、显式授权下另行发起。真实权限边界由工具层（工具白名单 / 权限模式 / 沙箱）强制；本条仅作默认行为定调与契约说明，不构成安全控制。
> 族内折叠指针（技能质量管理族 · 发布段）
> 本技能已归入 zfl-skill-publish-gate（本段唯一入口）。日常使用请从主技能进入。
> 目录与脚本资产保留，供主技能及其他技能直接调用，请勿重复实现本技能已有能力。
约束与错误处理
- 本技能是目录/发现中枢：只读扫描本地技能并生成清单，不执行技能安装（安装转交 zfl-skill-installer）、不跨电脑同步（zfl-skill-syncer）、不做质量评审（zfl-skill-quality-checker）。
- 主数据源为本地
scripts/skills_data.json；远程数据仅通过企微智能表 zip 导入（--from-zip），无在线 API 依赖。 - 错误处理：zip 路径缺失或 openpyxl 未装时显式报错退出；无 MD5 基线时降级为版本号比对并打印 WARN，不静默假装精准。
参考文档
references/FAQ.md：常见报错排障、避坑指南与场景示例（新手三件套/ROI/回滚）；遇到报错或想确认职责边界先查这里references/implementation-details.md：本地扫描、MD5 基线与差异比对的实现细节（grep: scan_local_skills / generate_md5_diff_report）scripts/skills_data.json：本地固化技能目录数据（主数据源，零 API 依赖）sub-skills/04_install/module.md：安装子流程（本目录 scripts/ 调用 zfl-skill-installer 完成落地）
输出与格式
- 输出格式：结构化文本，包含明确的章节划分与关键结论。
- 输出结构：按任务类型返回对应格式，确保可读性与可追溯性。
示例（技能目录生成与更新检查）
用户：「看看现在装了哪些技能」/「检查技能有没有更新」→ 本技能从本地固化 JSON（scripts/skills_data.json）与已扫描目录给出清单，并与远程智能表做 MD5 差异比对：
1. 扫描本地：遍历 <skills_root> 下已装技能，解析各自 SKILL.md frontmatter（name/version/layer/触发词），汇总本地技能清单。
2. 加载基线：读取 scripts/skills_data.json 中的 MD5 历史；若用户从企微导出了最新智能表 zip，则用 --from-zip 解析远程清单。
3. 差异比对：有 MD5 基线走文件哈希比对（精准）；无基线降级为版本号比对，并打印「新增 / 可更新 / 已落后」三栏报告。
4. 生成目录 JSON：把本地技能清单导出为 ui/skills.json，供 Web 面板（ui/index.html）渲染浏览。
5. 结论：列出可更新技能清单 + 建议动作（升级/保持），不自动安装——安装转交 zfl-skill-installer。
实际命令形态（<skills_root> 为技能根目录占位符）：
1) 列出本地全部已装技能（扫描 <skills_root> 目录并打印 JSON 清单）
2) 从企微导出的智能表 zip 做 MD5 差异比对（主命令；无子表名时默认读「技能库」sheet）
3) 生成 Web 面板用的目录 JSON（不传路径则默认输出到 ui/skills.json）
自检与成功标准
- 成功标准：输出满足任务声明的全部要求，关键信息完整无遗漏，视为完成。
- 输出前自检：核对输出是否覆盖全部要求项、数据是否准确、格式是否符合规范。
