# Generated: 2026-06-30
# ============================================================
# Meta-Skill Protocol Registry / meta-skill 协议注册表
# 23 entries — 16 agents (verifier replaces inspector)
# Consolidated: project-inspect, code-compliance, code-standards, security-check, code-logic → project-verify
# ============================================================

version: "2.1.0"
generated: "2026-06-30"

# ---- Agents ----
# Model configuration is now centralized in opespro-opencode.jsonc.
# The 'default_model' field provides fallback defaults if no config file is present.
agents:
  architect:
    default_model: livedata/qwen3-coder-next
    role: task orchestration and complex goal decomposition
  router:
    default_model: livedata/glm-4.7
    role: intent recognition and skill routing
  analyst:
    default_model: livedata/deepseek-v4-pro
    role: business analysis and requirement modeling
  builder:
    default_model: livedata/qwen3-coder-plus
    role: static page generation and style optimization
  debugger:
    default_model: livedata/deepseek-v4-pro
    role: bug fix and problem diagnosis
  git-master:
    default_model: livedata/qwen3-coder-plus
    role: git operations and workflow management
  historian:
    default_model: livedata/qwen3.6-plus
    role: project evolution tracking and changelog
  craftsman:
    default_model: livedata/qwen3-coder-plus
    role: skill creation and maintenance
  librarian:
    default_model: livedata/kimi-k2.5
    role: knowledge retrieval and document query
  looker:
    default_model: livedata/glm-5
    role: multimodal understanding
  scribe:
    default_model: livedata/qwen3-max
    role: documentation writing
  executor:
    default_model: livedata/qwen3-coder-plus
    role: focused execution of atomic tasks
  db-master:
    default_model: livedata/qwen3-coder-plus
    role: database operations and SQL execution
  v5-master:
    default_model: livedata/deepseek-v4-pro
    role: product development — cockpit, PRD, SQL, business logic
  explorer:
    default_model: livedata/deepseek-v4-pro
    role: exploration — codebase, web fetching, research
  verifier:
    default_model: livedata/deepseek-v4-pro
    role: unified project verification — structure, compliance, security, code quality, scripts, auto-fix

# ---- Easy ----
easy:

  easy:
    path: easy
    skill_name: easy
    description: "当用户用自然语言描述需求时使用，自动分析意图并路由到最佳子技能。不要用于已知技能名时（用 expert）。Use when user describes a need in natural language — auto-analyze intent and route to best sub-skill."
    triggers: ["easy", "简单", "快速", "帮我", "怎么", "如何", "检查", "修复", "创建", "分析"]
    agent_profile: router
    dispatch:
      method: task
      category: deep
      load_skills: ["easy"]

# ---- Auto ----
auto:

  auto:
    path: auto
    skill_name: auto
    description: "当需要编排复杂目标时使用：拆解为可执行子任务、并行调度、汇总结果。不要用于单一技能任务（用 easy）或已知技能名时（用 expert）。Use when you need orchestration of complex goals: decompose into executable sub-tasks, dispatch in parallel, and aggregate results."
    triggers: ["auto", "编排", "复合", "全面", "完整实现", "整套", "端到端"]
    agent_profile: architect
    dispatch:
      method: task
      category: deep
      load_skills: ["auto"]

# ---- Expert ----
expert:

  expert:
    path: expert
    skill_name: expert
    description: "当用户明确指定技能名直接调用时使用，支持中英文名称和完整参数控制。不要用于意图不明确时（用 easy）或复杂多技能协作时（用 auto）。Use when user explicitly specifies a skill name for direct invocation with full parameter control."
    triggers: ["expert", "专家", "完整", "深度", "自定义", "高级", "手动"]
    agent_profile: executor
    dispatch:
      method: task
      category: deep
      load_skills: ["expert"]

# ---- Workflow ----
workflow:

  ba:
    path: ba
    skill_name: ba
    description: "当用户输入/analyze、/audit、/doc命令，或需要业务流程分析、需求建模、PRD评审、5W1H分析时使用。不要用于代码实现、测试编写、架构设计。Use when users input /analyze, /audit, /doc commands, or need business process analysis, requirement modeling, PRD review, or 5W1H analysis."
    triggers: ["业务分析", "需求分析", "需求建模", "5W1H分析", "MECE", "analyze", "audit", "doc", "PRD", "评审"]
    agent_profile: analyst
    dispatch:
      method: task
      category: deep
      load_skills: ["ba"]

  baseline:
    path: baseline
    skill_name: baseline
    description: "当用户需要扫描原始业务文件并提取结构化业务基线数据时使用。不要用于需求分析、PRD编写、功能设计。Use when user needs to scan raw business documents and extract structured business baseline data."
    triggers: ["基线提取", "业务梳理", "条款提取", "制度分析", "baseline", "extract", "business constraints"]
    agent_profile: librarian
    dispatch:
      method: task
      category: deep
      load_skills: ["baseline"]

  bpm-workflow:
    path: bpm-workflow
    skill_name: bpm-workflow
    description: "当用户需要 BPM 审批流程设计、节点配置、会签/或签设置、穿透逻辑或 BizInfo 传递时使用。不要用于业务需求分析或代码实现。Use when user needs BPM approval workflow design, node configuration, countersign/or-sign settings."
    triggers: ["bpm", "审批", "workflow", "flow", "流程", "节点", "会签"]
    agent_profile: analyst
    dispatch:
      method: task
      category: deep
      load_skills: ["bpm-workflow"]

  bug-fixer:
    path: bug-fixer
    skill_name: bug-fixer
    description: "当用户报告Bug、错误、功能异常或需要调试时使用。不要用于功能开发或代码重构。Use when user reports bugs, errors, broken functionality, or needs debugging."
    triggers: ["修复Bug", "线上问题", "报错", "不对", "显示异常", "接口404", "数据不对", "debug", "调试", "bug", "error"]
    agent_profile: debugger
    dispatch:
      method: task
      category: deep
      load_skills: ["bug-fixer"]

# ---- Static Page ----
static-page:

  cockpit-page-builder:
    path: cockpit-page-builder
    skill_name: cockpit-page-builder
    description: "当用户需要生成驾驶舱(数据看板)静态HTML页面时使用。基于V5布局设计文档和PRD指标规范。不要用于一般HTML页面生成或Vue组件开发。Use when user needs to generate static HTML cockpit/dashboard pages."
    triggers: ["cockpit", "dashboard", "驾驶舱", "数据看板", "静态页面", "看板原型", "ECharts"]
    agent_profile: builder
    dispatch:
      method: task
      category: visual-engineering
      load_skills: ["cockpit-page-builder"]

  style-optimizer:
    path: style-optimizer
    skill_name: style-optimizer
    description: "专门优化前端HTML/CSS/JS显示效果。当需要调整页面样式、优化UI组件、统一设计语言时使用。Use when you need to optimize frontend HTML/CSS/JS display effects."
    triggers: ["优化样式", "调整样式", "美化", "优化UI", "调整显示", "改样式", "样式不对", "界面优化", "optimize style", "fix css"]
    agent_profile: builder
    dispatch:
      method: task
      category: visual-engineering
      load_skills: ["style-optimizer"]

# ---- Git ----
git:

  git-safe:
    path: git-safe
    skill_name: git-safe
    description: "当需要任何 git 操作时必须使用此技能：commit、branch、merge、rebase、stash。防止危险错误。Use when ANY git operation is needed - commit, branch, merge, rebase, stash."
    triggers: ["git", "commit", "branch", "merge", "rebase", "stash", "提交", "分支", "合并", "冲突解决"]
    agent_profile: git-master
    dispatch:
      method: task
      category: deep
      load_skills: ["git-safe"]

  git-workflow:
    path: git-workflow
    skill_name: git-workflow
    description: "当用户需要 git 工作流指导时使用：分支管理、cherry-pick、rebase、stash、冲突解决。Use when user needs git workflow guidance: branch management, cherry-pick, rebase, stash, or conflict resolution."
    triggers: ["git workflow", "cherry pick", "stash", "冲突", "分支管理", "git flow"]
    agent_profile: git-master
    dispatch:
      method: task
      category: deep
      load_skills: ["git-workflow"]

# ---- Quality ----
quality:

  project-verify:
    path: project-verify
    skill_name: project-verify
    description: "统一项目验证 / 结构检查、规范合规、安全扫描、代码质量、脚本可用性、自动修复 — 替代原 project-inspect + code-compliance + code-standards + security-check + code-logic。供 verifier subagent 或 architect 调用。Use for comprehensive project quality verification covering structure, compliance, security, code quality, scripts, and auto-fix."
    triggers: ["项目验证", "全面验证", "质量验证", "检查项目", "项目检查", "验证项目", "代码检查", "安全扫描", "规范检查", "合规检查", "巡检", "verify", "inspect", "audit"]
    agent_profile: verifier
    dispatch:
      method: task
      category: quality
      load_skills: ["project-verify"]

  code-review:
    path: code-review
    skill_name: code-review
    description: "当用户请求代码审查、评估代码问题、检查Pull Request或需要实现质量反馈时使用。Use when user requests code review, asks about code problems, evaluates pull requests."
    triggers: ["code review", "review", "代码审查", "code smell", "代码坏味道", "pull request"]
    agent_profile: executor
    dispatch:
      method: task
      category: deep
      load_skills: ["code-review"]

# ---- Meta ----
meta:

  skill-maintainer:
    path: skill-maintainer
    skill_name: skill-maintainer
    description: "当需要技能维护时使用：深度扫描所有 SKILL.md，对比模板检测缺失项、过时模式、格式不一致。不要用于单个技能编辑或一次性修复。Use when you need skill maintenance: deep-scan all SKILL.md files, detect gaps vs template."
    triggers: ["skill维护", "更新skills", "检查skills", "修复skills", "技能维护", "批量更新", "skill audit"]
    agent_profile: craftsman
    dispatch:
      method: task
      category: deep
      load_skills: ["skill-maintainer"]

  skill-refresh:
    path: skill-refresh
    skill_name: skill-refresh
    description: "当修改 SKILL.md 后需要刷新技能缓存时使用。不要用于普通技能执行或不相关任务。Use when skills need cache refresh after SKILL.md modification."
    triggers: ["refresh", "刷新", "reload", "更新技能", "热更新"]
    agent_profile: craftsman
    dispatch:
      method: task
      category: deep
      load_skills: ["skill-refresh"]

  skill-builder:
    path: skill-builder
    skill_name: skill-builder
    description: "当需要创建新技能或标准化现有技能时使用：交互式引导生成 SKILL.md、frontmatter 模板、触发词推荐、规范检查。不要用于修改已有技能的业务逻辑。Use when you need to create new skills or standardize existing ones."
    triggers: ["创建技能", "新建skill", "skill template", "技能模板", "生成skill"]
    agent_profile: craftsman
    dispatch:
      method: task
      category: deep
      load_skills: ["skill-builder"]

# ---- Tools ----
tools:

  evo-tracker:
    path: evo-tracker
    skill_name: evo-tracker
    description: "当用户需要追踪项目演进时使用：记录版本变更、生成 changelog、目录快照、维护演进历史。不要用于 git commit 追踪（git 已处理）。Use when user wants to track project evolution: record version changes, generate changelog entries."
    triggers: ["记录变更", "版本记录", "changelog", "演进记录", "目录快照", "版本历史", "evolution", "snapshot"]
    agent_profile: historian
    dispatch:
      method: task
      category: deep
      load_skills: ["evo-tracker"]

  workspace-manager:
    path: workspace-manager
    skill_name: workspace-manager
    description: "当需要管理 AI 工作目录时使用：上下文管理、临时文件清理、工作区重置、上下文快照保存。不要用于业务代码的修改或 Git 操作。Use when you need to manage AI workspace: context management, temp file cleanup, workspace reset."
    triggers: ["清理工作区", "workspace", "上下文管理", "重置工作区", "清理临时文件", "save context"]
    agent_profile: executor
    dispatch:
      method: task
      category: deep
      load_skills: ["workspace-manager"]

  module-doc:
    path: module-doc
    skill_name: module-doc
    description: "当用户需要分析代码模块并将代码逻辑、业务配置等形成业务文档时使用：包括但不限于生成时序图、类图、类描述、功能描述、配置参数文档等。不要用于代码实现、Bug 修复、代码审查或性能优化。Use when user needs to analyze code modules and generate business documentation."
    triggers: ["模块文档", "生成文档", "代码文档", "时序图", "类图", "配置文档", "架构文档", "module documentation", "sequence diagram"]
    agent_profile: scribe
    dispatch:
      method: task
      category: deep
      load_skills: ["module-doc"]

  model-preset:
    path: model-preset
    skill_name: model-preset
    description: "切换 opespro-opencode 的 Agent 模型预设。查看/切换当前 preset（opencode-go / livedata / budget）、设置单个 agent 模型。Use to switch agent model presets, view current model assignments, or set individual agent models."
    triggers: ["切换模型", "切换预设", "模型配置", "模型预设", "换模型", "查看模型", "model preset", "switch model", "模型列表"]
    agent_profile: craftsman
    dispatch:
      method: task
      category: deep
      load_skills: ["model-preset"]

  db-query:
    path: db-query
    skill_name: db-query
    description: "SQL 查询执行与安全校验 / 方言检查、危险操作拦截、参数化查询。Use for SQL execution, dialect checking, and safety validation."
    triggers: ["查询", "SQL", "建表", "DDL", "DML", "select", "insert", "update", "数据库", "表", "字段", "query", "database"]
    agent_profile: db-master
    dispatch:
      method: task
      category: deep
      load_skills: ["db-query"]

  db-schema:
    path: db-schema
    skill_name: db-schema
    description: "数据库表结构分析 / 表关系图谱、字段清单、索引分析。Use for table structure analysis, ER diagrams, and schema documentation."
    triggers: ["表结构", "表关系", "ER图", "字段", "索引", "外键", "DDL分析", "schema", "建表语句", "table structure"]
    agent_profile: db-master
    dispatch:
      method: task
      category: deep
      load_skills: ["db-schema"]

  db-connect:
    path: db-connect
    skill_name: db-connect
    description: "数据库连接管理 / 连接配置、连接测试、连接池管理。Use for database connection configuration and testing."
    triggers: ["数据库连接", "连接测试", "connection", "数据库配置", "host", "port", "连接池", "database connection"]
    agent_profile: db-master
    dispatch:
      method: task
      category: deep
      load_skills: ["db-connect"]

  code-workflow:
    path: code-workflow
    skill_name: code-workflow
    description: "代码开发工作流 / 分支管理、Commit规范 — 强制feat/fix分支，禁止master直接开发"
    triggers: ["开发分支", "分支管理", "创建分支", "workflow", "开发流程", "feat分支", "feature branch"]
    agent_profile: git-master
    dispatch:
      method: task
      category: quality
      load_skills: ["code-workflow"]
