Prompts-MCP 686 skills · ai / design / design-pattern / framework / fundamentals / habit / lang / tech-selection
/mcp/sse
root index.md medium

skills-root-index

Agent 技能的根索引 — 8 维度入口（lang / framework / design-pattern / habit / tech-selection / ai / fundamentals / design）

子项索引

子项 一句话
lang folder 语言级规则索引（Python / TypeScript / Java / JavaScript / SQL）
framework folder 框架/库使用约定索引 — 前端(React/antd/Vue3/Element Plus/GSAP) / Python(FastAPI/Tortoise) / Java(Spring 全家桶/MyBatis(-Plus)/MySQL/Redis/MQ/Security/调度/测试等)
design-pattern folder 设计模式索引 — 实战模式(Repository/Factory/Strategy/DDD/Pipeline/Assertion) + GoF 通用(SOLID/单例/建造者/代理/行为型) + 前端 React 组件模式
habit folder 流程习惯索引（baseline / commit / pr / prd-sync / error-code / code-quality / skill-authoring）
tech-selection folder 技术选型对比维度 — 跨语言/跨框架的「选哪个技术」决策（消息队列 / 数据库 / 缓存 / 搜索分析时序）
ai folder AI 应用开发维度 — 向量库选型 / LLM 框架 / RAG 工程 / LLM 调用规范 / Agent 与 MCP
fundamentals folder 程序员内功维度（规约+决策非八股）— Java/JVM + 前端浏览器/HTTP/构建原理
design folder UI 设计维度 — 通用规范(a11y/间距/字体/配色) + 主题风格(bento 默认/flat/wes/glass·极简等) + 设计语言 token + 组件模式

Agent Skills · 顶层路标

这是 /CLAUDE.md Step 5 的下钻起点。 8 维度，frontmatter 均含 paths / triggers，支持双向检索（顶层下钻 + 路径反查）。

规模一览

维度 中层 index 叶子 skill
lang 46 141
framework 49 177
design-pattern 11 27
habit 7 24
tech-selection 4 8
ai 5 18
fundamentals 6 22
design 4 15
合计 132 432

所有叶子均有 frontmatter（含 paths / triggers）通过 YAML 解析校验，可被反向检索。

8 大维度

维度 入口 一句话 何时进
lang lang/index.md 语法/语言级风格 任务涉及 .py / .ts / .tsx / .sql / .js / .java 文件
framework framework/index.md 框架/库的使用约定 任务涉及 React / antd / FastAPI / Spring Boot / MyBatis / Redis 等
design-pattern design-pattern/index.md 抽象设计模式 任务涉及分层、Repo、Factory、Strategy、Pipeline 决策
habit habit/index.md 流程/协作习惯 commit / PR / PRD-sync / 错误码 / 代码质量
tech-selection tech-selection/index.md 技术选型对比 选消息队列 / 数据库 / 缓存 / 搜索-OLAP 时
ai ai/index.md AI 应用开发 做 RAG / 调 LLM / 写 Agent / 选向量库或 AI 框架时
fundamentals fundamentals/index.md 程序员内功（规约+决策） 调 GC / 排查线上问题 / 选锁 / 分布式方案与一致性决策时
design design/index.md UI 设计规范 + 主题风格 写前端页面 / 选视觉风格（默认 bento）/ 定项目设计系统 token 时

两种下钻方式

方式 A：从顶层向下（场景驱动）

由 CLAUDE.md Step 5 调用：先看任务上下文落到哪个维度 → 进该维度 index → 看决策表选 1-3 个子项继续下钻。

任务上下文信号 进哪个维度 通常下钻深度
改某个 .py 文件 lang/python + framework/fastapi + design-pattern/ddd-layering 3-4 层
写新 .tsx 组件 framework/react/component + lang/typescript + design/foundations 3 层
写前端页面 / 还原设计稿 design/foundations + design/theme（默认 bento） + framework/react 3 层
选用什么视觉风格 / 切主题 design/theme/theme-selection 2 层
给项目定一套设计系统 / token / 换肤 design/design-language 2-3 层
写 SQL / migration lang/sql + framework/tortoise 3 层
改 PRD / 同步 manifest habit/prd-sync 2 层
设计新 Service design-pattern/ddd-layering + design-pattern/repository 3 层
写 LLM 编排 framework/fastapi/llm + design-pattern/pipeline 3 层
写 antd 表单 framework/antd/form + framework/antd/antd-mcp-usage.md 3 层
收工 PR habit/pr + habit/commit + habit/prd-sync 2 层
改某个 .java 业务方法 lang/java/pipeline-style + lang/java + framework/spring-boot 3-4 层
写 MyBatis Mapper / SQL 映射 framework/mybatis(-plus) + framework/mysql 3 层
集成消息队列 / 缓存 / 搜索 framework/{kafka,rocketmq,redis,redisson,elasticsearch} 3 层
选型：MQ / 数据库 / 缓存 哪个 tech-selection/{message-queue,database,cache} 2 层
GC 调优 / 排查 CPU 飙高、OOM、内存泄漏 fundamentals/{jvm,troubleshooting} 2-3 层
选锁 / 该不该用虚拟线程 / 分布式事务方案 fundamentals/{concurrency-internals,virtual-threads,distributed-theory} 2-3 层
实现分布式锁 / 幂等 / 分布式 ID fundamentals/distributed-theory + framework/{redisson,redis} 3 层
做 RAG / 调 LLM / 写 Agent / 选向量库 ai/{rag,llm-engineering,agent-mcp,vector-db,llm-framework} 3 层

方式 B：从文件路径反向命中（自动检索）

每个叶子 skill 在 frontmatter 声明 paths: ["<glob>"]。当你正在编辑的文件路径匹配某个 skill 的 paths，该 skill 强制进入加载清单（不论顶层下钻路径是否经过它）。

例：你在改 backend/services/textbook_cache.py → 自动命中以下叶子（部分）：

  • lang/python/naming/function-naming.md（paths: backend/**/*.py）
  • lang/python/async/no-blocking-call.md
  • lang/python/style/no-n-plus-one.md
  • design-pattern/repository/crud-contract.md（如果文件在 repositories/）
  • framework/fastapi/router/zero-logic-principle.md（如果文件在 routers/）

PostToolUse hook 会自动 echo 命中的 skill 到 stderr，提醒"你写完这段代码应该回头看一眼某 skill"。

跨切面主题速查（一个主题散在多维度时，从这里找入口）

有些主题天然横跨多维度，单靠维度下钻容易漏。下表给「主题 → 权威入口 + 相关落点」，避免各处建议不一致：

跨切面主题 权威入口（先看） 相关落点
幂等设计 fundamentals/distributed-theory/idempotent-design framework/kafka·rocketmq 的 idempotent（MQ 落地）/ mysql 唯一键
分布式锁 framework/redisson/distributed-lock framework/redis/distributed-lock（SETNX 视角）/ fundamentals/distributed-theory
分布式 ID fundamentals/distributed-theory/distributed-id framework/mysql/ops/distributed-id（DB 发号器落地）
分布式事务 fundamentals/distributed-theory/transaction-solutions framework/seata（AT/TCC/Saga 落地）
配置管理 framework/spring-boot/config-properties fundamentals/jvm/heap-params（JVM 启动参数）
日志规约 framework/observability/structured-logging framework/observability/skywalking-tracing（traceId 贯穿）
错误码体系 habit/error-code lang/java/error-handling（异常分类）/ design-pattern/assertion
缓存一致性 framework/redis/cache-patterns tech-selection/cache（选型）/ framework/observability
线上问题排查 fundamentals/troubleshooting fundamentals/jvm/oom-troubleshooting / framework/mysql/diagnosis
设计 token / 换肤 design/design-language/tokens-and-theming（框架无关三层模型） lang/typescript/style/design-tokens（antd ConfigProvider 落地）/ framework/react/theming/css-token-system（tokens.css 镜像）
视觉风格（默认 bento） design/theme/theme-selection design/theme/{bento,flat-design,wes-anderson,other-styles}
动效 / 动画（时长曲线/底线） design/component-patterns/motion-and-animation（时长/曲线/stagger 规约）+ design/foundations/accessibility（reduced-motion 底线） framework/gsap（GSAP 实现落地）
组件入场（每类组件用哪种） design/component-patterns/entrance-patterns（modal/drawer/toast/dropdown/list/tab… 速查） framework/gsap/{scrolltrigger,split-text,timeline-organization}（进视口/文字/序列落地）

原则：跨切面主题以「权威入口」为准，各维度的落点只讲自己那部分的落地，不重复给方案。新写这类 skill 时务必回链权威入口（见 /.claude/skills-philosophy.md 信条 3）。

规则

  1. 一个任务最多同时激活 3 个维度的叶子（避免上下文炸裂）
  2. 每个维度下钻最多 3 层 index 跳转（叶子层不算下钻）
  3. 读完 index.md 后必须继续下钻到具体规则文件 — 只读 index 不算「加载了技能」
  4. 下钻前若发现某 skill paths: 字段匹配当前文件路径 → 强制进入
  5. 叶子文件 ≤ 100 行（严格遵守，超就拆）

链接