用途:在 PCL 标准库(191 个技能、15 个分类)中定位适用技能,并说明如何组合。核心原则是按任务而非技术路由:先看用户想做什么,再按仓库实际使用的技术收窄。
技能分两类:领域专家(<domain>-expert,回答“X 如何工作、最佳实践是什么”)与流程(<activity>-workflow,回答“按什么顺序做什么”)。一个任务通常各需一个:流程驱动顺序,专家提供判断。组合而非堆叠,加载流程加一两个真正相关的专家即可。
查找方式:目录为机器可读,可用 jq 查询 skill-catalog.json 或 skill-index.json,按关键词、分类或名称筛选;也可用 find、grep 在文件系统中查找。每个描述含明确的 Use when 子句,应读该子句而非凭名称猜测。
分类图涵盖 workflows、languages、frameworks、api、data、devops、cloud、ai、security、qa、tools、domains、professional、scientific、design。注意 design/design-expert 指软件架构而非视觉设计,界面技能是 accessibility-expert。
重叠技能需区分:测试自家应用用 playwright-expert,抓取站点数据用 browser-automation-expert;审查流程用 code-review-workflow,代码质量维度用 code-review-expert;安全入侵调查用 incident-response-expert,生产缺陷用 debugging-workflow;事务型用 postgresql-expert/mysql-expert,分析型用 analytical-databases-expert;持续事件用 stream-processing-expert,定时批处理用 airflow-expert;提示与输出用 llm-engineering-expert,调用工具用 agent-engineering-expert;文档问答用 rag-expert,检索用 elasticsearch-expert。
组合模式示例:测试先行加 API 功能用 tdd-workflow → api-design-expert → 语言技能 → code-review-workflow;结账变慢用 debugging-workflow → performance-expert → 数据库或框架技能;文档助手用 rag-expert → llm-engineering-expert →(若调用工具)agent-engineering-expert → identity-access-expert;加固发布流水线用 supply-chain-security-expert → cicd-expert → secrets-management-expert;仪表盘无障碍用 accessibility-expert → 框架技能 → qa-expert;大表无停机迁移用 refactoring-workflow → 数据库技能 → sre-expert。
无匹配技能时:按标签而非预期名称搜索;检查 references/,主题可能是更广技能中的一节(如 rails 在 ruby-expert,spark 在 databricks-expert);检查更广技能是否覆盖。若确实缺失,判断标准是它是否为独立决策上下文而非独立技术。用 skill-creator-expert 编写,用 scripts/validate-skills.py 校验。
最佳实践:加载前读 Use when 子句;流程性问题先看 workflow;加载两三个而非六个;优先具体技能;尽早咨询 security/;跟随引用链接而非再加载技能。反模式:孤立按关键词路由(JavaScript 中的 Java 不等于 java-expert)、加载所有相关技能、有具体技能却选通用技能、跳过流程技能即兴发挥、因技能未按主题命名就认为缺失。
资源:stdlib/catalog/skill-index.json、stdlib/catalog/skill-catalog.json、stdlib/SKILLS_INVENTORY.md、stdlib/CHANGELOG.md、skill-creator-expert。