Skill · 突破性与优势 · code-review 实践
下一步 Space · 上一步 · 概览 O · 备注 N
1/1
2026.03 前端分享会 · 第一部分

Skill:突破性与优势

code-review Skill 为例:把评审流程与团队规范写成“写一次、处处生效”的工程资产。

本次结构

  • 突破性:为什么 Skill 不是“又一个 Prompt”
  • 优势:工程化的稳定、可控与复用
  • 定义:前端视角理解 Skill
  • 实践:code-review 的 Step 0 + 五维
  • 闭环:Skill + MCP,用真实规范避免幻觉

一句话

Skill 把“指令”变成“资产”:可复用、可版本管理、可协作落地。
提示:这页可用空格逐条出现,先讲“突破性”,再讲“优势”。
全屏F11 · 导出 PDFCtrl+P
文件:skills-share.html
突破性 写一次、处处生效

从“每次重说”到“文件化工作流”

不是省几句 Prompt,而是把 AI 行为做成可复用、可审计的工程定义。

过去(对话式)

  • 每次都要贴流程、补上下文、强调输出格式。
  • 不同人 / 不同轮次,结论结构不稳定。
  • 知识散落在聊天里:复用难、迭代难。

现在(Skill)

  • 把“何时用/怎么做/输出什么样”写进 SKILL.md
  • 匹配场景自动携带:不用每次重说
  • 可版本管理:进 Git、可 Review、可迭代
强调“写一次处处生效”= 可复用 + 可协作 + 可版本。
下一步(Reveal / Next)Space
突破性
突破性 你的流程、你的规范

从“通用 AI”到“可预期、可追溯、可协作”

Skill 把团队约定写成步骤与输出格式,让结果稳定、可复盘。

可预期

  • 固定流程:例如评审必须先拉规范,再给结论。
  • 固定输出:Critical/Important/Suggestion + Verdict。

可追溯

  • 强制引用:每条相关结论带 ruleId/sourceFile。
  • 整改有“对照表”,复盘有证据链。

可协作

  • Skill 是文件:可分享、可评审、可迭代。
  • 新人/新 Agent 直接继承同一标准。
这页收束突破性:可预期(流程/输出)+ 可追溯(引用)+ 可协作(文件)。
概览O·备注N
突破性
优势 稳定、可控、可扩展

优势不是“更聪明”,而是“更工程化”

把 AI 变成流程的一环:复用、交付、协作、标准化。

优势清单(逐条出现)

  • 可复用:一次编写,多处复用,不重复造轮子。
  • 场景自动匹配:When to Use / description 描述触发场景。
  • 输出可控:固定结构,便于逐条改,也便于自动化接入。
  • 团队知识沉淀:从“口口相传”到“仓库资产”。
  • 门槛低:改 Markdown 即用,无需训练/部署。

关键加成:与 MCP 结合

  • 用真实数据:规范/文档/工具由 MCP 提供。
  • 避免幻觉:先拉规范再下结论,而不是“凭空编”。
  • 结构化引用:ruleId/sourceFile 带回输出,形成闭环。
金句:Skill 定“流程与标准”,MCP 提供“真实数据”。
这页用 build 做“PPT 感”:优势列表逐条出现。
下一条Space·上一条
优势
定义 前端视角

Skill = 一份“说明书”(何时用 / 怎么做 / 输出什么样)

类比:ESLint 规则 / 组件库文档 / 工程 SOP。关键是“文件化 + 可版本”。

形态与落点

  • 存储:个人 ~/.cursor/skills/ 或项目 .cursor/skills/
  • 结构:目录 + 必选 SKILL.md
  • 内容:YAML(name/description)+ When to Use + Steps + Output Format

最小可用轮廓(示意)

---
name: my-skill
description: 什么时候用、解决什么问题
---

## When to Use
- 场景 A

## Steps
1. 先做什么

## Output Format
## Summary
## Critical / Important / Suggestion
## Verdict
强调“结构化输出”是把 AI 纳入工程链路的关键。
概览O
定义
实践 code-review

把“评审代码”写成可复现流程(并强制规范引用)

目标:输出稳定、可追溯;相关问题必须带 ruleId/sourceFile。

When to Use / 五维(逐条出现)

  • 合并前:PR/改动合入前评审
  • 实现后:功能完成后评估
  • 审他人/审 Agent:统一标准输出结论
  • 重构/修 bug 后:审修复 + 回归测试
  • 五维:Correctness / Readability / Architecture / Security / Performance

Step 0:先拉团队规范(关键)

  • 先跑 standards_*:list →(必要时)refresh → get_rules
  • 引用落地:相关 finding 必须带 ruleId + sourceFile
  • 严重度映射:must/forbidden→Critical;discouraged→Important;recommended/optional→Suggestion
若当前没有 standards_* 工具,则跳过 Step 0,
仅按五维做通用评审,不要虚构规范。
这页建议现场打开 SKILL.md 读 Step 0 原文两行,增强可信度。
下一条Space
实践
闭环 Skill + MCP

用真实数据把流程闭环:规范先到,结论再出

Skill 规定必须查规范;MCP 提供 standards_* 工具读取真实规范条目。

配合流程

  • Skill:规定流程与输出结构
  • MCP:提供真实规范/文档/工具能力
  • 输出:ruleId/sourceFile 让整改可追溯
核心价值:避免“凭空编规范”,让评审从经验输出升级为可审计的规范引用。

mcp.json(摘录)

{
  "mcpServers": {
    "jdy-code-standards-mcp": {
      "command": "node",
      "args": [
        "D:/JDY/Kevin/库/jdy-code-standards-mcp/dist/jdy-code-standards-mcp.min"
      ],
      "env": {}
    }
  }
}
提醒:这页可以落到“为什么 Skill 有突破性”:可追溯=可执行。
概览O·备注N
闭环
小结 落地路径

怎么从 0 开始做一个团队可复用的 Skill?

先稳定交付,再用 MCP 接真实数据源,最后把它变成团队资产。

三步落地(逐条出现)

  • 先写 SKILL.md:When to Use / Steps / Output Format 三件套。
  • 先固定输出结构:分级 + Verdict,让整改“可执行”。
  • 再接 MCP:规范/文档/工具接为真实数据源,避免幻觉。
回到突破性:写一次处处生效 · 你的流程你的规范 · 可版本管理可协作

演示操作

  • 翻页/Reveal / Space
  • 回退(先回退 Reveal,再回退页面)
  • 概览O
  • 备注N
最后一句:Skill 是把 AI 纳入工程体系的最短路径(流程、规范、版本、协作)。
谢谢
2026.03 · Skill