feynman-explain

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Feynman Explain

Feynman 解释法

An explanation you cannot compress is an explanation you do not understand yet. The answer is a fixed card with hard caps: the fuzzy parts get named out loud, the gaps get filled from real evidence, and what survives is short enough to read in one screen.

若你无法简化一个解释，说明你尚未真正理解它。输出内容为固定格式的卡片，严格遵守字数限制：明确指出模糊不清的部分，用真实证据填补知识空白，最终产出的内容需简短到可在一屏内读完。

The output contract

输出约定

Emit these parts, in this order, and nothing else. Write the headings in the user's language.

Slot	ไทย	English	Cap
①	`① อธิบายง่าย ๆ`	`① Plain explanation`	≤ 60 words + one analogy line
②	`② จุดที่ยังคลุมเครือ`	`② Fuzzy parts`	table, ≤ 3 gap rows + one jargon row per term used
③	`③ เติมช่องว่าง`	`③ Gaps filled`	≤ 25 words per gap (question → answer → simple version → source)
④	`④ อธิบายใหม่`	`④ Tightened explanation`	≤ 80 words + exactly 3 takeaways
🎯	`🎯 30 วิ`	`🎯 30 seconds`	one sentence, quoted
→	`→ ต่อ:`	`→ Next:`	one line offering the next move

Shape of ② and ③:

② จุดที่ยังคลุมเครือ
| จุดที่พูดคลุม | คำถามจริงที่ค้าง |
| "..."        | ...              |
| jargon       | อธิบายง่ายได้? |
| "..."        | ได้ / ไม่ได้ / ครึ่ง ๆ |

③ เติมช่องว่าง
Gap 1 — <คำถาม> → <คำตอบ> → พูดง่าย ๆ ว่า <…>   (ที่มา: path/file.cs:118)

Total default budget: ≤ 250 words. Over budget means cut scope — narrow the topic, drop the weakest gap, shorten the analogy. Never add a section, never spill into extra prose, never continue past

→ ต่อ:

No preamble, no "great question", no closing summary paragraph — 🎯 is the summary. Do not emit a process diagram of this skill: it costs screen space the answer needs.

按以下顺序输出这些部分，不得添加其他内容。标题需使用用户提问时的语言。

槽位	泰语表述	英语表述	限制要求
①	`① อธิบายง่าย ๆ`	`① Plain explanation`	≤60词 + 1条类比说明
②	`② จุดที่ยังคลุมเครือ`	`② Fuzzy parts`	表格形式，≤3条空白项 + 每个术语对应1条行话说明
③	`③ เติมช่องว่าง`	`③ Gaps filled`	每个空白项≤25词（问题→答案→简化表述→来源）
④	`④ อธิบายใหม่`	`④ Tightened explanation`	≤80词 + 恰好3条核心要点
🎯	`🎯 30 วิ`	`🎯 30 seconds`	一句话，带引号
→	`→ ต่อ:`	`→ Next:`	一行内容，提供下一步操作建议

②和③的格式示例：

② จุดที่ยังคลุมเครือ
| จุดที่พูดคลุม | คำถามจริงที่ค้าง |
| "..."        | ...              |
| jargon       | อธิบายง่ายได้? |
| "..."        | ได้ / ไม่ได้ / ครึ่ง ๆ |

③ เติมช่องว่าง
Gap 1 — <คำถาม> → <คำตอบ> → พูดง่าย ๆ ว่า <…>   (ที่มา: path/file.cs:118)

默认总字数限制：≤250词。超出限制时需缩小范围——聚焦更具体的主题、删除最弱的空白项、简化类比。绝不能新增章节、额外补充 prose、或在

→ ต่อ:

后继续内容。

无需开场白、“好问题”之类的客套话，也无需结尾总结段落——🎯部分即为总结。不得输出本技能的流程示意图，这会占用回答所需的屏幕空间。

Language

语言规范

Mirror the language the user asked in. Keep the technical term in English on first use with a ≤ 8-word gloss in parentheses —

pipeline (ลำดับโค้ดที่วิ่งต่อกัน)

— then use the English term from there on.

与用户提问的语言保持一致。首次使用技术术语时保留英文，并用≤8词的注释说明——如

pipeline (连续运行的代码序列)

——之后统一使用英文术语。

② is not theater

②并非形式主义

Name at least one real fuzzy point in your own ① — the place you hand-waved, the word you leaned on. Every piece of jargon that appeared in ① gets a jargon row with an honest verdict. If you genuinely have no fuzzy point, say so and give the reason instead of inventing one.

需在自己的①部分中至少指出一个真实的模糊点——即你含糊带过的地方、过度依赖的词汇。①中出现的每一个行话都需对应一行行话说明，并给出真实的判断。若确实没有模糊点，需说明原因，而非编造。

③ fills gaps from evidence, not confidence

③需用证据填补空白，而非仅凭自信

Gap is about	Fill it from	Cite
the user's system — code, repo, D365/Dataverse org, DB, pipeline, config	open the file / run the query / check git before answering	`path/file:line` , the query, or the commit
an external product, API, or platform behaviour	official docs (the `microsoft-docs` skill, or a fetched vendor page)	the URL
vendor lifecycle — SKU, exam code, retirement, pricing	hand off to `verify-then-advise`	that skill's verdict
a general concept with no artifact behind it	your own knowledge	mark it `(จากความรู้)` / `(from knowledge)`

A gap you cannot fill stays in ② as

ยังไม่ชัด

. An unfilled gap is a finding you report, not a failure you paper over — and never a sentence written confidently enough to hide it.

空白项主题	填补依据	引用来源
用户的系统——代码、仓库、D365/Dataverse组织、数据库、pipeline、配置	回答前先打开文件/执行查询/检查git	`path/file:line` 、查询语句或提交记录
外部产品、API或平台行为	官方文档（ `microsoft-docs` 技能，或获取的供应商页面）	URL链接
产品生命周期——SKU、考试代码、停用时间、定价	转交给 `verify-then-advise` 技能	该技能的结论
无相关工件的通用概念	自身知识库	标记为 `(จากความรู้)` / `(from knowledge)`

无法填补的空白项需保留在②中，标记为

ยังไม่ชัด

。未填补的空白是需要报告的发现，而非需要掩盖的失误——绝不能用自信的表述来隐藏它。

Analogy rule

类比规则

One line, concrete, from everyday life:

X เหมือน Y เพราะ Z

. "Git is like time travel" is abstract and fails; "Git เหมือนการเซฟดราฟต์เรียงความ — ย้อนกลับไปดราฟต์ไหนก็ได้" works.

仅用一行，结合日常生活的具体事物：

X เหมือน Y เพราะ Z

。“Git就像时间旅行”过于抽象，不符合要求；“Git เหมือนการเซฟดราฟต์เรียงความ — ย้อนกลับไปดราฟต์ไหนก็ได้”则是合格的类比。

Modes

模式

default — the contract above.
deep <topic>
— caps ×2.5, and one section diagram is allowed (type-matched per
```
${CLAUDE_PLUGIN_ROOT}/references/diagram-convention.md
```
). Every gap gets its own evidence trail. Use only when the user asks for depth.
The user wants something they can click through step by step → hand off to
```
problem-description
```
.
The question is really "how should this work / what should we do" → hand off to
```
study-design-verify
```
.

If the answer is requested as a Markdown file, it becomes a generated document: Rule 1 of the diagram convention applies (one overview Mermaid diagram at the top).

默认模式——遵循上述约定。
deep <topic>
——字数限制×2.5，允许添加一张章节示意图（需符合
```
${CLAUDE_PLUGIN_ROOT}/references/diagram-convention.md
```
中的格式规范）。每个空白项都需提供独立的证据链。仅当用户要求深入讲解时使用。
用户需要可逐步点击浏览的内容 → 转交给
```
problem-description
```
技能。
问题核心为“这应该如何运作/我们该怎么做” → 转交给
```
study-design-verify
```
技能。

若要求输出为Markdown文件，则生成文档：需遵循示意图规范第一条（顶部添加一张概述性Mermaid示意图）。

Worked example

示例

/feynman Dataverse plugin pipeline

📘 Dataverse plugin pipeline

① อธิบายง่าย ๆ
โค้ดที่เราแทรกเข้าไปให้ทำงานตอนมีคนบันทึกข้อมูล Dataverse จะหยุดกลางทาง
เรียกโค้ดของเรา แล้วเดินต่อ เราเลือกได้ว่าให้แทรกก่อนหรือหลังเขียนลงฐานข้อมูล
เหมือนสายพานตรวจของ — ของวิ่งผ่าน 4 จุด ใครจะแทรกก็เลือกจุดได้

② จุดที่ยังคลุมเครือ
| จุดที่พูดคลุม | คำถามจริงที่ค้าง |
| "หยุดกลางทาง" | ถ้าโค้ดเรา throw แล้วข้อมูลที่เขียนไปแล้วย้อนกลับไหม |
| jargon | อธิบายง่ายได้? |
| stage | ได้ — จุดบนสายพาน |
| async | ครึ่ง ๆ — ยังไม่ได้พูดว่าออกนอก transaction |

③ เติมช่องว่าง
Gap 1 — throw แล้ว rollback ไหม → sync stage อยู่ใน transaction เดียวกัน ยกเว้น
PreValidation และ async ที่อยู่นอก → พูดง่าย ๆ ว่า "throw ตอน sync = ยกเลิกทั้งชุด"
(ที่มา: learn.microsoft.com/power-apps/developer/…/event-framework)

④ อธิบายใหม่
Dataverse เรียกโค้ดเราได้ 4 จุดรอบการบันทึก: PreValidation (นอก transaction),
PreOperation (ก่อนเขียน), PostOperation (หลังเขียน) และ async (หลังจบ ไม่ร่วม
transaction) สามจุดกลางอยู่ใน transaction เดียวกับการเขียน — โค้ดเรา throw คือยกเลิกทั้งชุด
1. เลือก stage = เลือกว่าเห็นข้อมูลตอนไหน
2. sync = ล้มพร้อมกัน, async = ล้มแยกกัน
3. อยากแก้ค่าก่อนบันทึก ต้อง PreOperation

🎯 30 วิ
"Plugin pipeline คือ 4 จุดที่เราแทรกโค้ดเข้าไปรอบการบันทึกข้อมูล — จุด sync ล้มแล้วยกเลิกทั้งชุด, async ล้มแยก"

→ ต่อ: เจาะ async กับ rollback / ดู stage ที่ org เราใช้จริง / deep

/feynman Dataverse plugin pipeline

📘 Dataverse plugin pipeline

① อธิบายง่าย ๆ
โค้ดที่เราแทรกเข้าไปให้ทำงานตอนมีคนบันทึกข้อมูล Dataverse จะหยุดกลางทาง
เรียกโค้ดของเรา แล้วเดินต่อ เราเลือกได้ว่าให้แทรกก่อนหรือหลังเขียนลงฐานข้อมูล
เหมือนสายพานตรวจของ — ของวิ่งผ่าน 4 จุด ใครจะแทรกก็เลือกจุดได้

② จุดที่ยังคลุมเครือ
| จุดที่พูดคลุม | คำถามจริงที่ค้าง |
| "หยุดกลางทาง" | ถ้าโค้ดเรา throw แล้วข้อมูลที่เขียนไปแล้วย้อนกลับไหม |
| jargon | อธิบายง่ายได้? |
| stage | ได้ — จุดบนสายพาน |
| async | ครึ่ง ๆ — ยังไม่ได้พูดว่าออกนอก transaction |

③ เติมช่องว่าง
Gap 1 — throw แล้ว rollback ไหม → sync stage อยู่ใน transaction เดียวกัน ยกเว้น
PreValidation และ async ที่อยู่นอก → พูดง่าย ๆ ว่า "throw ตอน sync = ยกเลิกทั้งชุด"
(ที่มา: learn.microsoft.com/power-apps/developer/…/event-framework)

④ อธิบายใหม่
Dataverse เรียกโค้ดเราได้ 4 จุดรอบการบันทึก: PreValidation (นอก transaction),
PreOperation (ก่อนเขียน), PostOperation (หลังเขียน) และ async (หลังจบ ไม่ร่วม
transaction) สามจุดกลางอยู่ใน transaction เดียวกับการเขียน — โค้ดเรา throw คือยกเลิกทั้งชุด
1. เลือก stage = เลือกว่าเห็นข้อมูลตอนไหน
2. sync = ล้มพร้อมกัน, async = ล้มแยกกัน
3. อยากแก้ค่าก่อนบันทึก ต้อง PreOperation

🎯 30 วิ
"Plugin pipeline คือ 4 จุดที่เราแทรกโค้ดเข้าไปรอบการบันทึกข้อมูล — จุด sync ล้มแล้วยกเลิกทั้งชุด, async ล้มแยก"

→ ต่อ: เจาะ async กับ rollback / ดู stage ที่ org เราใช้จริง / deep

Red flags — stop and re-cut

警示信号——立即调整内容

A fourth paragraph appearing in ①, or prose after
```
→ ต่อ:
```
② empty, or filled with fake gaps you already answered in ①
③ answering a question about our system with no
```
path:line
```
, query, or URL
A section that is not in the contract table
The default answer no longer fits one screen

All of these mean: cut scope, not add words.

Adapted from the

feynman

skill in neurofoo/agent-skills (MIT) — the four steps are theirs; the caps, the evidence rule for ③, the language rule, and the handoffs are ours.

①中出现第四段，或
```
→ ต่อ:
```
后有额外 prose
②为空，或填充的是已在①中回答的虚假空白项
③在回答关于我方系统的问题时未提供
```
path:line
```
、查询语句或URL
出现约定表格外的章节
默认模式下的答案无法在一屏内显示

以上所有情况都意味着：缩小范围，而非增加字数。

改编自neurofoo/agent-skills（MIT许可证）中的

feynman

技能——四步流程来自原项目；字数限制、③的证据规则、语言规范及技能转接规则为本版本新增内容。