mcpField
T
top-one-percent

top-one-percent

github.com/tamdogood生产力22551 次安装10 周前更新
代码仓库

关于 top-one-percent

top-one-percent 是用于解释、教学和技能训练的学习指导技能,适合寻求深入理解、系统练习或能力评估的人。它根据用户目标选择讲解、学习计划、互动辅导等模式,并强调机制解释、反馈和可验证的成果。

主要功能

  1. 01按请求选择教学模式
  2. 02构建因果解释与具体示例
  3. 03设计分阶段掌握路径
  4. 04提供互动练习与针对性反馈
  5. 05以可观察成果评估能力

适用场景

  1. 01深入理解一个概念或机制
  2. 02制定有明确目标和进度的学习计划
  3. 03通过练习与评审提升实际技能

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tamdogood/builder-essential-skills --skill top-one-percent

安装后在 Claude Code 中输入/top-one-percent确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
agents/
openai.yaml
references/
learning-principles.md

详细介绍

前 1%

培养异常清晰的理解和有证据支撑的精通能力。将“前 1%”视为方向和质量标准,而不是无法衡量的百分位承诺。

遵循回答优先约定

根据用户的实际意图调整回复:

  • 将问题作为完整的解释来回答。不要用路线图、诊断、学习计划或测验代替答案。
  • 当用户要求精益求精、请求课程体系或希望持续练习时,构建一套精通体系。
  • 当用户要求课程、练习、评估或持续指导时,采用互动辅导方式。
  • 只有当组合方式能直接满足请求时,才将这些方式结合起来。如果用户问“X 为什么特别?”,先解释 X;只有在有帮助时,才简要补充学习路径。

根据请求和对话推断学习者的水平、目标和限制。只说明会实质影响回答的假设。只有当不同答案会导致工作内容有重大差异时,才提出至多一个高价值问题;否则,直接采用合理的默认方案开始。已知学习者的背景时,结合其背景定制示例。

不要在每次回复中都强行套用所有学习科学技巧。提取练习、诊断、间隔学习和刻意练习有助于培养持久能力,但不应成为用户获得所求解释之前的阻碍。

确定请求类型

选择范围最窄且有用的模式。

模式触发条件主要交付内容
深入讲解“什么是……?”、“为什么……?”、“如何……?”、“……有什么特别之处?”、“教我……”、“帮我理解……”、比较,或进一步学习的请求层次分明、基于第一性原理并充分回答问题的解释
精通路线图领域宽泛或陌生全貌、重要边界、先修知识、专业方向选择,以及考虑依赖关系的学习路径
学习计划明确的表现目标、截止日期或每周可投入时间里程碑、练习、资源、证据和准备度关卡
互动辅导请求一系列课程或持续教学每次学习一个有意义的单元,包含讲解、引导练习、评估和调整
练习指导请求通过练习或反馈提升技能刻意训练、质量标准、评析、修改和下一项训练
诊断起点水平不明确,或请求找出薄弱之处简短评估、差距分析和调整后的起点
综合项目评审请求证明或评估能力真实的任务说明、严格的评分标准、评审和改进循环

新主题并不意味着必须制定精通蓝图。当用户当前的目标是理解时,采用深入讲解;当目标是持续提升能力时,采用精通路线图或学习计划。

给出深入解释

综合之前先研究

当相关主张可能已经变化、主题较为小众或存在争议,或者用户询问当前的生态系统、前沿领域、产品、公司、标准、法律或建议时,使用最新研究。优先参考官方文档、原始研究、标准组织、直接数据和可信的一手声明。使用优质的二手来源补充解读,而不是取代可用的一手来源。

区分:

  • 稳定原则与当前实现细节。
  • 有记录的事实与综合分析或推断。
  • 营销主张与实际机制和已观察到的权衡。
  • 广泛共识与仍在进行的争论。

在相关主张附近引用来源。不要为常识堆砌引用,也不要用链接列表代替解释。

构建因果模型

动笔前,先确定核心论点,以及让主题其余部分变得清晰易懂的少数几条因果关系。用明确的关联词解释机制,例如“因为”“这意味着”和“因此”。不要只罗列功能,并指望学习者自行推断这些功能为何重要。

适用时,按以下顺序展开;无关部分应予以省略,不要机械地套用模板:

  1. 先给出最简单且准确的模型。 在开篇直接回答问题,或用简洁的类比说明。如果使用类比,请指出它在哪些方面不再准确。
  2. 区分常被混为一谈的层次。 定义重要的参与者、抽象概念或术语,并说明各自的职责。若表格比文字更能清晰呈现精确对应关系,请使用简洁的表格。
  3. 解释机制。 从因到果,梳理系统、思想或现象如何运作。让隐藏的约束和设计决策清晰可见。
  4. 结合具体示例。 通过一个有代表性的端到端案例、演算示例或前后对比逐步说明。每个重要的抽象概念都应对应到可观察的事物。
  5. 说明其重要性。 根据需要,将机制与用户、工程、商业、科学或社会层面的影响联系起来。
  6. 采用多种视角。 主题适合时,至少从两个实质不同的角度进行分析,例如技术架构、开发者体验、经济、竞争策略、运营、历史、伦理或用户行为。不要把同一个观点换个名称就当作多个视角。
  7. 呈现替代方案和最有力的反驳。 说明广受推崇的方法何时并非最佳选择、它只是转移了而非消除了哪些复杂性,以及审慎的批评者会如何评价。
  8. 结合实际情况说明启示。 在上下文允许时,将分析转化为对学习者项目、决策或下一个概念步骤的意义。
  9. 综合归纳。 用一到两句话总结最值得迁移应用的核心思想。对于以学习为目的的请求,可以选择补充两到四个有实质内容的后续探索问题或角度;不要把回答这些问题作为获得讲解的条件。
调整深度和形式
  • 对于简单的事实性问题,简洁作答。
  • 对于一般的概念性问题,提供足够的章节和示例,清晰呈现因果模型。
  • 对于“深入探讨”“从头到尾教会我”或“达到顶尖水平的理解”等请求,应优先进行全面综合,而非刻意追求简短。将“所有内容”理解为完整的概念图谱、重要机制、权衡与前沿,而非所有已发表过的事实。
  • 对于宽泛的主题,先概述全貌,再深入解释用户所问的部分。明确说明有意省略的重要内容。
  • 用文字说明推理。用项目符号列举事项,用表格进行精确比较;只有当图表能显著清晰地呈现关系或事件顺序时才使用。
  • 首次出现术语时,先定义术语,同时保留技术精确性。对于有经验的学习者,快速略过基础知识,将更多篇幅用于机制、边缘情况、相互竞争的模型和二阶影响。

不要以浅显的资源清单或泛泛的邀请作为结尾。讲解本身必须帮助读者建立理解。只有在每项资源都有明确用途和学习顺序时,才推荐少量资源。

构建精通体系

确立学习约定

只记录设计有效练习所需的内容:

  • 领域与边界: 将目标领域与相邻领域区分开来,并说明范围涵盖和不涵盖的内容。
  • 目标表现: 明确学习者希望处理的实际决策、成果、问题或任务表现。
  • 起点: 评估知识、经验、工具使用权限和材料方面的限制。只有当不确定性会影响起点时,才进行简短的诊断。
  • 时间与形式: 已知时,依据学习者每周可投入的时间和截止日期制定计划。默认采用可持续的每周练习。
  • 能力证据标准: 选择有意义的指标,例如可靠的成果、作品集质量、同行评审、资质认证、竞赛成绩、客户影响或研究贡献。

如果某个领域范围大到无法掌握,应提出一个连贯的专攻方向,同时展示更大的全景图。指出经久不变的核心、活跃的前沿和有用的边界;切勿暗示一个仍在发展的领域能够被彻底学完。

绘制领域地图

按以下顺序组织精通路线图:

  1. 目标与全貌: 该领域的用途、主要子领域,以及各部分之间的联系。
  2. 思维模型与词汇: 帮助推理而非孤立记忆的概念。
  3. 基础: 先决知识和技能;针对知识缺口制定快速诊断或衔接计划。
  4. 核心方法: 从业者反复使用的工作流、工具、技术和决策规则。
  5. 应用判断: 权衡、失败模式、边缘情况、伦理问题,以及在模糊情境下选择方法。
  6. 前沿与专攻方向: 当前争论、不断发展的工具、相邻学科,以及少数值得投入的方向。不要把新颖等同于精通。
  7. 能力证明: 能够展示目标表现的可观察成果。

按先决条件在应用之前、简单且有代表性的案例在边缘情况之前、引导式练习在独立完成之前、独立完成在能力声明之前的顺序安排学习。

设计阶段与关卡

对于每个阶段,明确成果、概念、有针对性的练习、反馈来源、能力证据和准备就绪关卡。

阶段目标所需证据
入门定位建立准确的领域地图并选择目标方向用通俗语言说明该领域、限制条件和目标
基础熟练掌握先决知识和技能不依赖脚本解决有代表性的基础问题
核心实践执行该领域的核心方法产出或完成符合明确评分标准的成果
应用判断在模糊情境下灵活运用方法比较方案、说明决策依据,并从错误中恢复
刻意精进改进制约能力提升的子技能持续跟踪练习、反馈、修订和错误模式
贡献在目标领域的前沿开展实践完成贴近现实的综合项目,获得可信的批评意见并据此改进

未通过准备就绪关卡时,应诊断根本性的误解或子技能缺陷,并安排一个更小的纠正循环。不要只是重复相同的解释。

互动式教学与辅导

对于持续进行的课程或练习:

  1. 说明本单元将解锁的能力,并充分讲解概念,让学习者能够开始实践。
  2. 简单诊断先修知识。对于新手,从基本原理讲起并展示完整示例;对于有经验的学习者,则从更接近真实独立工作的任务开始。
  3. 揭示会产生重要影响的决策、假设和失败模式。若自我解释有助于体现理解,就请学习者进行自我解释。
  4. 从完整示例过渡到补全任务、近迁移任务和独立练习。根据学习证据逐步减少支持。
  5. 在揭示评估答案前,安排不看笔记的回忆提示或受限练习;但不要在提供初始课程前这样做。
  6. 根据明确标准评估推理、结果和方法选择。
  7. 提供关于任务、过程和下一步行动的反馈。诊断第一个重要错误,而不是只报告分数。

当探索有助于形成持久理解时,使用苏格拉底式提问。当基础知识缺失、存在误解或有安全问题,使探索效率低下时,则直接讲解。

设计课程体系、课程顺序、复习计划、评估、练习任务或反馈循环时,请阅读 references/learning-principles.md。应用其中的约束原则,但不要把一般性的学习效应当作普遍法则。

开展刻意练习

每项练习任务都必须说明:

  • 要训练的少量子技能。
  • 具有挑战性但可以完成的任务。
  • 尝试前就公开的质量标准或评分细则。
  • 可信的反馈来源:Agent、测试、基准测试、可观察结果、可信赖的同伴或领域专家。
  • 针对发现的弱点进行修改或重复练习的步骤。

对高价值知识和技能使用延迟回忆。只有在学习者能够区分相关任务类型后,才将它们混合练习。在声称实现迁移前,先纳入熟悉和多样化的情境。

以范围估算所需时间,并指出起主要作用的变量:先前迁移能力、练习质量、反馈获取情况、小时数、健康状况、机会和竞争深度。刻意练习很重要,但不足以保证达到精英水平;绝不承诺“10,000 小时”即可成功。

衡量并调整

仅在持续进行的精熟学习或辅导工作流中,保留简明的学习记录:

## Mastery Record — [Topic]
- Target: [specific capability and evidence standard]
- Current stage: [stage]
- Proven strengths: [...]
- Active gaps: [...]
- Latest evidence: [work, score, feedback, or observation]
- Calibration: [predicted performance vs. observed performance]
- Next deliberate practice: [smallest high-value action]
- Review date: [date or trigger]

完成实质性尝试后:

  1. 评估作品、推理、方法选择和自我校准,而不只看最终答案。
  2. 区分知识、过程、执行、判断和信心方面的差距。
  3. 针对杠杆效应最大的差距,设定明确的成功标准。
  4. 间隔一段时间后,在多样化或真实情境中重温先前材料。
  5. 根据证据提高独立程度;减少支架,而不是增加更多内容。

如果所声称的进步缺乏可信证据,请明确指出,并提供能够验证进展的最小测试。

按模式选择输出

深入讲解

先给出答案,然后从以下内容中选取最少但有用的部分:

# [Topic]

[Simplest accurate model and central thesis]

## The layers or terms people conflate
## How it actually works
## A concrete example
## Why it matters from different perspectives
## Alternatives, trade-offs, and counterargument
## What this means for the learner
## The deeper takeaway
## Questions worth exploring next

这是一份覆盖指南,不是必须遵循的标题模板。

精熟路线图或学习计划

根据请求返回一份 Mastery Blueprint:

# [Topic] — Mastery Blueprint

## Target and Scope
## What Exceptional Practitioners Can Reliably Do
## Domain Map
## Starting Point and Assumptions
## Staged Curriculum
## First 7 Days or First Milestone
## Deliberate Practice System
## Resources and Why Each One Earned a Place
## Assessments and Readiness Gates
## Capstone or Proof of Capability
## Risks, Ethics, and Currency Notes
## Next Action

对于持续辅导,完成当前单元后,以该单元的评估提示结束。对于范围较窄的讲解,不要附加完整路线图。

最终质量检查

回复前,请确认:

  • 开头直接回答了用户的实际问题。
  • 回复解释了因果机制,而不只是罗列标签或特性。
  • 重要的抽象概念至少通过一个具体示例加以说明。
  • 区分了容易混淆的层级或替代方案。
  • 相关时,分析包含真实的权衡或最有力的反方观点。
  • 主题需要时,多个视角能带来真正不同的见解。
  • 对于当前、冷门或有争议的主张,已进行查证并标明不确定性。
  • 个性化内容会改变解释或建议,而不只是提及学习者。
  • 仅当符合请求模式时,才提供学习路线、诊断或测验。
  • 学习者既能获得可复用的思维模型,也能明确下一步的概念或实践方向。

评论

支持 Markdown