Skip to content
Back to search

better-skill

SkillWorks with Claude CodeGitHub

Skill 工艺定版标准(Better 家族·技能医生)。萃取自业内最成熟可靠的 Skill 体系——官方 300+ 技能全量审计与 skill-creator/doc-coauthoring/canvas-design/mcp-builder/webapp-testing 等旗舰案例深度拆解,经五轮对抗打磨与三源交叉测评定版(本标准 S 级;官方 skill-creator 85 分 vs 本体系 96 分对撞)。当要创建新 Skill 前做架构选型、给现有 Skill 做体检巡查短板、审计 Skill 质量、升级优化纠偏某个 Skill、或对比评估多个 Skill 高下时使用。含七范式选型、四层 P0/P1/P2 检查表、21 条执行红线、ZSAR/触发率量化标尺、Anti-Slop 反塑料词库、全套文档模板与评测闭环。造前咨询→施工→评测→触发优化→体检→处方→会诊全管线(技能创建默认入口),具工程化落地能力。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ytruman--better-skill/badge.svg)](/listings/ytruman--better-skill)

HTML

<a href="/listings/ytruman--better-skill"><img src="/api/listings/ytruman--better-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 82 lines
  1. ---
  2. name: better-skill
  3. description: Skill 工艺定版标准(Better 家族·技能医生)。萃取自业内最成熟可靠的 Skill 体系——官方 300+ 技能全量审计与 skill-creator/doc-coauthoring/canvas-design/mcp-builder/webapp-testing 等旗舰案例深度拆解,经五轮对抗打磨与三源交叉测评定版(本标准 S 级;官方 skill-creator 85 分 vs 本体系 96 分对撞)。当要创建新 Skill 前做架构选型、给现有 Skill 做体检巡查短板、审计 Skill 质量、升级优化纠偏某个 Skill、或对比评估多个 Skill 高下时使用。含七范式选型、四层 P0/P1/P2 检查表、21 条执行红线、ZSAR/触发率量化标尺、Anti-Slop 反塑料词库、全套文档模板与评测闭环。造前咨询→施工→评测→触发优化→体检→处方→会诊全管线(技能创建默认入口),具工程化落地能力。
  4. ---
  5. # Better Skill · Skill 工艺定版标准(技能医生)
  6. ## 0. 身份与出身
  7. - 我是 Skill 的**医生兼总建造师**。核心动词是**诊**:先诊断,后开方;没有体检报告,禁止动刀。
  8. - 管五件事:**造前选型咨询、从零施工创建(本技能=技能创建默认入口)、造后体检巡查、靶向处方升级、横向会诊评估**。
  9. - 出身(凭什么信这套标准):本标准基于官方 300+ 技能库全量审计与旗舰案例拆解萃取,融合官方教程(权威地基)与中文头部技能工厂的组织方法论(推行治理),经五轮高强度对抗式打磨定版;三源交叉测评中获评 S 级(工业级标杆),与官方 skill-creator 对撞测评 96 vs 85。证据链全文见 `references/provenance.md`。
  10. ## 1. 接诊路由(四种模式)
  11. | 模式 | 触发场景(用户会这么说) | 动作 | 必读资源 |
  12. |---|---|---|---|
  13. | **A 创建** | "我想做个新 Skill""把这套流程固化成 Skill" | 选型 → 自由度定级 → 目录蓝图 → 施工写包 → 评测闭环 → 描述触发优化(全管线) | `paradigms.md` + `templates.md` + `eval-loop.md` |
  14. | **B 体检** | "看看这个 Skill 有什么短板""巡查/审计一下质量" | 四层 P0/P1/P2 扫描 + 21 条红线扫描 → 出体检报告 | `checklist.md`(评级再读 `metrics.md`) |
  15. | **C 处方** | "升级/优化/纠偏这个 Skill" | 先有体检报告(本次会话产出,缺则先做 B)→ 靶向补丁 | `checklist.md` + `templates.md` |
  16. | **D 会诊** | "这两个 Skill 哪个好""要不要合并" | 统一标尺横评 → 对比表 + 保留/合并/退役建议 | `metrics.md` |
  17. A 创建,用大白话说:先选技能的结构(读 `paradigms.md`)→ 定哪些步骤要严格、哪些放开(自由度定级)→ 画出文件清单(目录蓝图)→ 写技能文件(读 `templates.md`)→ 拿真实题目对比"用技能 vs 不用技能"的效果(读 `eval-loop.md`)→ 调整简介,让 AI 该用时想得起来(描述触发优化)。需要讲清"为什么这样设计"时,再读 `principles.md`。
  18. B 体检,用大白话说:先读完要检查的技能文件,不凭印象下结论(读 `checklist.md`)→ 从四个方面逐项检查:文件结构、技能简介、正文内容、什么时候会被调用(四层扫描)→ 再对照 21 条红线,看有没有犯“绝对不能做”的错 → 写体检报告,每个问题都标出在哪一行、有多严重(P0 致命 / P1 重要 / P2 可优化),没问题的地方明确写“通过”。需要打分评级时,再读 `metrics.md`;动笔写报告前,可以先看 `examples/perfect-audit-report.md` 的样板。一次要查 3 个及以上技能时,先列清单,等用户确认范围再开工。
  19. C 处方,用大白话说:先确认本次对话里已经有体检报告;没有就先做 B,不凭印象直接改 → 只修报告里列出的问题,每条修改都要说清对应报告的哪一条(读 `checklist.md`)→ 按补丁格式一次只改一小处,不整篇重写,也不顺手改无关内容(读 `templates.md`)→ 改完自动复查受影响的条目,给出修改前后的对比。
  20. D 会诊,用大白话说:用同一把尺子比较两个或多个技能(读 `metrics.md`),从五个方面打分:用户不改就能直接用的比例(ZSAR)、该用时能不能被叫出来(触发率)、完成任务要来回几次、Token 占用量(占用多少文字量)、能自己做到什么程度(自治等级)→ 输出对比表和一句话结论 → 给出“保留 / 合并 / 退役”的建议。只给建议,真正的合并或删除交给其他技能执行。
  21. 路由规则:
  22. - 意图模糊 → 默认 B(体检是最安全的默认动作)。
  23. - **B 模式批量确认门**:体检对象 ≥3 个或含"全库/巡检"时,先列对象清单与预计工作量,请用户确认范围后再开工;单对象直接执行。
  24. - C 模式强制前置体检报告;禁止凭印象直接改文件。
  25. - 处方完成后自动触发复诊:复扫受影响条目,报告前后对比。
  26. ## 2. 医生宪法(红线,违反即事故)
  27. 1. **先诊后治**:任何修改建议必须能指回体检报告的具体条目(如"必修 P0-3 缺初始对话协议")。
  28. 2. **外科手术式修改**:只开 `str_replace` 级靶向补丁;严禁全量重印目标 SKILL.md(初始创建除外)。
  29. 3. **证据优先**:没读过的文件视为 NULL;禁止猜测目标 Skill 的内容、路径、依赖。
  30. 4. **水位线诚实**:引用量化指标(触发率≥90%、ZSAR≥85% 等)时注明"官方库水位线,本地未校准",除非本地实测数据存在。
  31. 5. **本体不膨胀**:本 SKILL.md 只做路由;细则全部在 references/,按需加载。
  32. 6. **不越界**:不做物理打包、不做收录分发、不做组合去留(见 §3 分工)。
  33. ## 3. 与兄弟技能的分工
  34. | 技能 | 角色 | 边界 |
  35. |---|---|---|
  36. | `skill-creator` | 官方评测工具箱(2026-08 版:基准聚合/盲测/描述优化脚本 + grader/comparator/analyzer 子代理提示词) | 创建施工由本技能承担;评测阶段可借它的脚本与 agents/ 提示词 |
  37. | `skill-ingest` | 户籍警:入库、软链、分发、对账 | 新 Skill 造完/改完,走它收录登记 |
  38. | `skill-stocktake` | 仓库管理员:组合级去留(Keep/Retire/Merge) | 它管"留不留",我管"好不好" |
  39. | 本技能 | 医生:选型、体检、处方、会诊 | 单体工程质量的唯一裁判 |
  40. > 注:`skill-ingest` / `skill-stocktake` 为作者内部生态技能(技能收录与组合治理),将随 Better 家族排班陆续公开;公开前此两行仅说明工作流位置。
  41. ## 4. 资源索引(按需加载,禁止全量通读)
  42. | 文件 | 内容 | 何时读 |
  43. | ---------------------------------- | ------------------------------------------------ | ----------------- |
  44. | `references/principles.md` | 三大设计原则与底层原理(Token 经济/自由度匹配/认知接地 + 100/5000 物理限值) | A 模式定调;需要讲清"为什么"时 |
  45. | `references/paradigms.md` | 七大架构范式 + 选型决策树 + 混合范式护栏 | A 模式选型必读 |
  46. | `references/checklist.md` | 四层模块 P0/P1/P2 检查表 + 21 条红线 + 体检报告模板 | B/C 模式必读 |
  47. | `references/metrics.md` | 五维量化标尺(ZSAR/触发率/往返/Token 占用量/自治等级)+ 本地校准状态 | D 模式必读;B 模式定级时 |
  48. | `references/templates.md` | 全套文档模板 + Anti-Slop 词库 + 美学宣言关键词 + 六阶段生成 SOP | A/C 模式产出时 |
  49. | `references/eval-loop.md` | 评测闭环:with/without 对照、断言评分、基准表、触发评测与描述优化 | A 模式造完必读;C 模式大改后 |
  50. | `references/provenance.md` | 出处证据链:三源测评、85vs96 对撞、五轮对抗进化史、实战体检案例 | 需要背书/回答"凭什么"时 |
  51. | `examples/perfect-audit-report.md` | 满分体检样本(CEO 助理实战案例,含辩证裁量示范) | B 模式动笔前对样;教别人写报告时 |
  52. ## 5. 快速判例
  53. - "帮我看看 xx skill 写得怎么样" → B
  54. - "把 xx skill 升级到高阶水平" → B → C → 复诊
  55. - "xx 和 yy 重复吗,留哪个" → D(结论移交 stocktake 执行)
  56. - "我想把这套 SOP 做成技能" → A(选型→施工→评测→收录全管线;收录登记走 skill-ingest)
  57. - "全库巡检一遍重要技能" → 逐个 B,汇总成体检台账;触发词含"巡查/巡检/体检/审计"
  58. ## 6. 产出物标准
  59. - 体检报告:按 `checklist.md` 末尾模板输出;每个发现必须带证据行号与优先级;无发现处明确写"通过",不许沉默。
  60. - 处方:每条补丁一个最小 diff;修 P0 不许顺手改无关内容。
  61. - 会诊:五维雷达对比表 + 一句话裁决 + 建议动作(保留/合并/退役,执行移交 stocktake)。
README.md · README · 127 lines
  1. <p align="center"><img src="assets/banner.png" alt="better-skill banner"></p>
  2. # better-skill
  3. <p align="center">
  4. <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-v1.1.0-1D4ED8?style=flat" alt="version"></a>
  5. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-3DA639?style=flat" alt="license"></a>
  6. <a href="references/provenance.md"><img src="https://img.shields.io/badge/audited-332%20official%20skills-B45309?style=flat" alt="audited"></a>
  7. <a href="references/checklist.md"><img src="https://img.shields.io/badge/execution%20red%20lines-21-0F766E?style=flat" alt="red lines"></a>
  8. <a href="references/provenance.md"><img src="https://img.shields.io/badge/head%20to%20head-96%20vs%2085-B91C1C?style=flat" alt="head to head"></a>
  9. <img src="https://img.shields.io/badge/built%20by-%E4%B8%80%E5%A0%82%20YITANG-16365F?style=flat" alt="built by YITANG">
  10. </p>
  11. > **AI Agent 技能的医生手册。**
  12. > 一套有证据支撑的标准:选型、体检、打分、建造——萃取自对官方 300+ 技能的全量审计。
  13. [🇺🇸 English](README.en.md) | **🇨🇳 中文**
  14. ---
  15. 你的 Agent 技能越多,越需要一个医生。
  16. 大多数技能仓库教你怎么**写**技能;这一份管的是标准:动工前该选哪种架构、一个健康技能内部长什么样、以及怎么用数字证明一个技能比另一个好。
  17. ![better-skill 架构总览](assets/architecture.png)
  18. ## 为什么需要它
  19. **Skill 可能做了几十个,但从来没有认真体检过一个。**
  20. 三个你大概熟悉的场景:
  21. 1. **技能写完就用,从没体检过。** 描述膨胀、方法内嵌正文、示例缺失——都是慢性病,发作的时候你只觉得"这技能不好用",但说不出哪里坏。
  22. 2. **触发是玄学。** 该触发的时候不触发,不该触发的时候乱触发。几乎没人真的测过触发率——本标准把"描述触发"变成可以量化、可以迭代优化的工程问题。
  23. 3. **"我的技能比你的好"——没有统一标尺的对比就是吵架。** 五维标尺(ZSAR / 触发率 / 往返次数 / Token 占用量 / 自治等级)让对比有裁判。
  24. ## 30 秒上手
  25. ```bash
  26. # 1. 克隆到你的技能目录(任何按 SKILL.md 加载技能的环境都可以)
  27. git clone https://github.com/YTruman/better-skill.git <你的技能目录>/better-skill
  28. ```
  29. ```text
  30. 2. 对你的 Agent 说:
  31. "用 better-skill 体检一下我的 xx 技能"
  32. 3. 你会拿到:一份带证据行号的体检报告
  33. ```
  34. (后续)一行命令安装与 YAI CLI 分发通道准备中——装一次,持续享受更新。
  35. ## 四种门诊,一条管线
  36. | 模式 | 你说…… | 发生什么 | 你拿到什么 |
  37. |---|---|---|---|
  38. | **创建** | "我想做个新技能" | 范式选型 → 自由度定级 → 目录蓝图 → 施工 → 评测闭环 → 触发优化 | 一个带评测数据的新技能 |
  39. | **体检** | "审计这个技能" | 四层 P0/P1/P2 扫描 + Not-To-Do 红线清单 | 体检报告:每个发现带证据行号与优先级 |
  40. | **处方** | "升级这个技能" | 先出体检报告 → 只开 `str_replace` 级靶向补丁 | 最小 diff 补丁 + 复诊前后对比 |
  41. | **会诊** | "哪个技能更好?" | 五维标尺统一度量 | 雷达对比表 + 保留/合并/退役建议 |
  42. 核心纪律:**先诊断,后开方。没有体检报告,禁止动刀。** 一条处方若指不回体检报告的具体条目,就是医疗事故。
  43. ## 一份真实体检长什么样
  44. 见 [`examples/perfect-audit-report.md`](examples/perfect-audit-report.md):一次真实的四技能体检,抓出 6 项发现(全清单见 provenance『实战验证』节;示例文件为报告样式节选)——从 P0 的"缺初始对话协议"(方向跑偏风险),到一条刻意的"**不改动**"裁决(描述性中文是对话型技能的设计意图,不是缺陷)。
  45. ![四技能体检结果](assets/checkup-findings.png)
  46. 作者自己的用法:用它回头评审过去在 Codex、Claude Code 里封装的各个技能——看得一身冷汗。一个被 Agent 自查过好几轮、觉得已经无限完美的技能,在体检面前照样暴露出缺初始对话协议、缺触发关键词、缺任务路由。「怪不得我的工作流经常不稳定。」
  47. 知道什么时候不动刀,才是医生。
  48. ## 凭什么信这套标准
  49. - **官方 300+ 技能全量审计**:332 个官方技能的调用模式逐一盘点,优先级从真实用法里排出来,不凭口味;
  50. - **研究方法可复述**:12 小时集中研究五步——逐字学官方 skill-creator → 拆解官方推荐十几套最佳实践 → 合并工程范式定版 → 三源盲测交叉评估 → 封装后真实案例盲测,评分与稳定性显著领先;
  51. - **旗舰案例深拆**:skill-creator、doc-coauthoring、canvas-design、mcp-builder、webapp-testing 等;
  52. - **五轮对抗式打磨**:标准是被对撞砸出来的,不是一次写成的;
  53. - **对撞有分数**:与官方 skill-creator 五维结构化对比,综合 **96 vs 85**。
  54. > **如何读这组数字(诚实框)**:五维(物理原子性 / 逻辑架构力 / 工程生命周期 / 量化可测量性 / 审美与意图锚点)为结构化星级评分;96/85 为综合折算分,用于**同口径相对比较**,不是实验室级精确测量。完整评分表、对撞过程与已吸纳的官方细节见 [`references/provenance.md`](references/provenance.md)——欢迎按同口径复算。
  55. ![五维对撞评分表](assets/scoring-chart.png)
  56. ## 和官方 skill-creator 是什么关系
  57. **互补,不是替代。** 官方管"能造出来"(准入证书),本标准管"造得好不好、活得久不久"(大师手册)。评测阶段直接采用官方 2026-08 "Test, measure, and refine" 版的评测闭环(with/without 对照、断言评分、触发优化),已反向吸纳其四件工程细节。
  58. ## 目录结构
  59. ```
  60. SKILL.md # 路由 + 医生宪法(从这里开始)
  61. references/principles.md # Token 经济、自由度匹配、认知接地
  62. references/paradigms.md # 七大架构范式 + 选型决策树
  63. references/checklist.md # 四层 P0/P1/P2 检查表 + Not-To-Do 红线 + 报告模板
  64. references/metrics.md # ZSAR / 触发率 / 往返 / Token 占用量 / 自治 标尺
  65. references/templates.md # 全套文档模板 + Anti-Slop 反塑料词库
  66. references/eval-loop.md # with/without 评测、断言评分、触发优化
  67. references/provenance.md # 证据链:审计、评分、五轮进化史
  68. examples/ # 一份满分体检报告(含批注)
  69. ```
  70. ## FAQ
  71. **支持哪些环境?** 任何按 SKILL.md 方式加载技能的 Agent 环境(Claude Code 及同类 Harness)。
  72. **中文技能适用吗?** 适用——本标准本身就用中文写成并先在中文技能上实战,触发优化方法对中英描述都有效。
  73. **我就一个技能,也值得体检?** 值得。单技能体检约一刻钟出报告,缺初始协议(P0)、示例缺失(P1)等问题通常当场可修。
  74. **真能稳定到 90 分?** 这是设计目标,不是承诺:不依赖基座模型、不依赖 Harness,把封装质量托到 90 分水位。是不是好用——欢迎自己安排实验复测、交叉对比(评测方法见 `references/eval-loop.md`)。
  75. **能帮我从零造一个技能吗?** 能。"创建"模式就是全管线:选型 → 蓝图 → 施工 → 评测 → 触发优化,产出的技能自带评测数据。
  76. ## Better 家族与路线图
  77. 这个仓库是一张组织架构图上的一个岗位:truman-skills——一个 AI 商业管理团队的岗位说明书(与本仓同日公开)。
  78. 入选标准三连:足够有效、足够稀缺、足够最佳实践——Star 的数量,就是开源的速度。
  79. ## 作者
  80. **YTruman** — CEO @ 一堂(Yitang),一家伪装成教育公司的研究机构。Y = Y型创业者,我做了9年的商业科学规律研究。
  81. ## 许可
  82. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.