mfg-machine-elements-mechanisms-and-tolerances
Use when specifying parts and how they fit together: machine elements including bearings, fasteners, springs, gears and shafts, mechanisms and kinematics with degrees of freedom and linkages, and tolerances and geometric dimensioning and tolerancing — what a tolerance actually costs and why over-tolerancing is the expensive default.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 5
- Forks
- 3
01 前言 Front Matter
- name
- mfg-machine-elements-mechanisms-and-tolerances
- description
- Use when specifying parts and how they fit together: machine elements including bearings, fasteners, springs, gears and shafts, mechanisms and kinematics with degrees of freedom and linkages, and tolerances and geometric dimensioning and tolerancing — what a tolerance actually costs and why over-tolerancing is the expensive default.
03 SKILL.md 正文
Manufacturing and Mechanical Engineering: Machine Elements, Mechanisms and Kinematics, and Tolerances and GD&T
Part 2 of 5 of the Manufacturing and Mechanical Engineering for Software Devs reference (plugin
manufacturing-mechanical-engineering-for-software-devs), covering §6–§8. Sibling skills:mfg-mechanics-stress-fatigue-and-materials(§0–§5),mfg-process-families-machining-additive-and-moulding(§9–§16),mfg-dfm-metrology-plm-npi-and-what-transfers(§17–§24),mfg-reference(§25–§30). Section numbers are shared across the set; a reference written as §N →skillpoints into that sibling skill.Currency: The mechanics is settled. Two areas moved. See §25 →
mfg-referencefor additive manufacturing after its correction, and industrial robotics adoption.
⚠️ Companion to a civil/industrial engineering reference. ⚠️ That one covers flow, constraints and safety systems; this one is about physically MAKING things — and the lessons are different.
⚠️ The governing asymmetry: in software the marginal cost of a change is near zero and in manufacturing it is enormous. ⚠️ Almost every practice in this document is a response to that one fact — tolerances, DFM, PLM, EVT/DVT/PVT gates, and the reason mechanical engineers appear conservative to software people.
⚠️ GOTCHA boxes mark the intuitions that don't survive contact with atoms.
The three ideas that organize this document:
- ⚠️ NOTHING IS EXACT — everything is a tolerance (§8). The single biggest mental shift for software people: there is no equality in the physical world, only distributions, and a design that requires exactness is a design that fails.
- ⚠️ The PROCESS determines the design, not the other way round (§9 →
mfg-process-families-machining-additive-and-moulding, §17 →mfg-dfm-metrology-plm-npi-and-what-transfers). Geometry that's free in CAD can be impossible, or absurdly expensive, to make.- ⚠️ FATIGUE kills things that were never overloaded (§4 →
mfg-mechanics-stress-fatigue-and-materials). Most mechanical failures happen far below the static strength, after many cycles — the physical analogue of a bug that only appears after a million requests.
§6. Machine Elements
⚠️ Most mechanical design is SELECTING standard components, not designing new ones.
⚠️ FASTENERS ⚠️ a bolted joint works by CLAMPING — preload creates
friction that carries the load, and the bolt should ideally not
see shear directly. ⚠️ This is why TORQUE SPEC matters and why
under-torqued bolts fatigue and fail
⚠️ Torque is a poor proxy for preload (friction scatter is large),
which is why critical joints use angle or stretch measurement
⚠️ BEARINGS rolling vs plain vs fluid film. ⚠️ Rated by L10 life —
a STATISTICAL life at which 10% have failed, not a guarantee
⚠️ GEARS ratio, module/pitch, ⚠️ backlash (lost motion on reversal —
a real problem in positioning systems)
SPRINGS · SEALS (⚠️ dynamic seals are a common failure point) ·
COUPLINGS · belts and chains
⚠️ Standard parts exist and should be used: ⚠️ ISO/ANSI threads, standard bearing
sizes, stock material thicknesses. ⚠️ A custom fastener is a supply chain liability
forever (§22 → mfg-dfm-metrology-plm-npi-and-what-transfers).
⚠️ Threadlocking, prevailing-torque nuts and lock washers — ⚠️ and note that ordinary
split lock washers have been shown to be largely ineffective, which is folklore that
persists.
§7. Mechanisms and Kinematics
⚠️ Degrees of freedom, linkages (⚠️ four-bar being the workhorse), cams, and the distinction between kinematics (motion) and dynamics (forces causing it).
⚠️ GOTCHA — EXACT CONSTRAINT (kinematic) design is the concept software people find most surprising and most useful. ⚠️ A rigid body has six degrees of freedom; constrain each exactly once and the assembly is deterministic. ⚠️ OVER-CONSTRAINT — the intuitive "add more bolts and pins to make it solid" — forces parts to fight each other, transmits manufacturing variation into stress, and produces assemblies that bind or warp unpredictably. ⚠️ The classic example: a three-legged stool never rocks; a four-legged one does, because it's over-constrained. ⚠️ The software analogue is real: redundant sources of truth don't add robustness, they add contradiction.
⚠️ Vibration and resonance: ⚠️ every structure has natural frequencies; excite one and amplitude grows until damping or failure limits it. ⚠️ Modal analysis, damping, tuned mass dampers, and the practical rule to keep excitation frequencies away from natural ones.
§8. ⚠️ Tolerances and GD&T
⚠️ THE conceptual shift for software people. In the physical world there is no equality — only distributions. ⚠️ A "10 mm" hole is never 10 mm; it is 10 mm ± something, and the design must work across the whole range.
⚠️ TOLERANCE the permitted variation. ⚠️ TIGHTER TOLERANCE COSTS
MORE, often NON-LINEARLY — halving a tolerance can multiply cost
several-fold by forcing a different process (§9) or added
inspection. ⚠️ Over-tolerancing is the most common and most
expensive novice error in mechanical design
⚠️ FITS clearance · transition · interference (⚠️ press fits, where
the parts are deliberately the "wrong" size)
⚠️ STACK-UP ⚠️ tolerances ACCUMULATE across an assembly
⚠️ WORST CASE sum of all tolerances — safe, expensive, and
astronomically unlikely
⚠️ STATISTICAL (RSS) root-sum-square — realistic, and it
ASSUMES independence and centred distributions, which
real processes often violate
⚠️ GD&T (ASME Y14.5 / ISO GPS) ⚠️ specifies FUNCTION rather than
just dimensions: form (flatness, straightness), orientation
(perpendicularity, angularity), location (⚠️ TRUE POSITION),
and runout — all relative to explicitly declared DATUMS
⚠️ MMC / BONUS TOLERANCE ⚠️ as a feature departs from maximum
material condition, extra positional tolerance becomes
available — because the ASSEMBLY still works. This is
tolerancing the FUNCTION, not the number
⚠️ Why GD&T exists at all: ⚠️ plus/minus dimensioning is ambiguous about what matters and creates square tolerance zones where the function wants round ones. ⚠️ GD&T states the design intent unambiguously, which is exactly what a specification should do. ⚠️ DATUMS are the key idea: ⚠️ they define how the part is referenced and therefore how it is measured and fixtured — and inconsistent datums between design, manufacture and inspection is a recurring source of parts that "measure fine" and don't fit.
PART II — MAKING THINGS
04 同仓库更多 Skills
white-paper-writing
Use when writing white papers, technical reports, policy documents, thought leadership pieces, or any long-form authoritative document. Triggers on requests to write, structure, outline, or review white papers, technical reports, position papers, policy briefs, or evidence-driven arguments. Also use for B2B content marketing strategy, technical documentation requiring authority, academic-style reports, or any document that must educate while persuading. Use when someone asks "how should I structure this" for a long-form document.
prose-technical-mechanics
Use when editing or writing prose at a technical/mechanical level: choosing between Anglo-Saxon and Latinate diction, placing information in topic vs stress positions, writing periodic vs cumulative sentences, handling sentence rhythm, punctuation as logic, transitions, paragraph structure, or phonesthetics. Use when someone wants to understand WHY prose works or doesn't, not just surface-level style advice. Triggers on word choice, sentence structure, emphasis, rhythm, diction, or any deep writing mechanics question.
prose-mechanics
Use when writing, editing, or analyzing prose style; when trying to avoid generic AI-sounding writing; when applying specific prose styles such as journalistic, academic, narrative, KJV biblical, Hemingway plain, Latinate/Jamesian, Orwellian, Augustan, Victorian, Early Modern (Bacon, Browne, Milton), or free indirect discourse; or when coaching someone on writing voice and mechanics. Triggers on any request to improve, analyze, or write in a specific prose style, to fix "AI-sounding" writing, to make prose more vivid or concrete, to vary sentence rhythm, or to understand how a particular writer achieves their effects.
narrative-structure
Use when structuring stories, pitches, presentations, white papers, or any persuasive narrative; analyzing the hero's journey in fiction or non-fiction; applying StoryBrand for business communication; designing narrative arcs for thought leadership; or understanding Vogler, Snyder, Propp, or Campbell frameworks. Triggers on any narrative structure, storytelling, pitch structure, StoryBrand, hero's journey, three-act structure, Freytag, Save the Cat, narrative arc, or "how should I structure this story/pitch/presentation" request.
legal-brief-writing
Use when writing legal briefs, motions, or any court filing; when analyzing judicial cognition and persuasion; when applying elite brief-writing techniques from Roberts, Clement, Kagan, Garner; or when structuring legal arguments for maximum persuasion. Also use for autistic/neurodivergent advocates who need to understand how their natural communication style maps to elite legal advocacy. Triggers on any legal writing, brief drafting, motion preparation, or legal argument structuring request.
journal-publishability-criteria
Use whenever a research paper, article or preprint is being written, revised, reviewed or published, and specifically before every publication of docs/paper.md. Covers what legitimate journals actually gate on, in order of gating — the editor's desk screen (scope, novelty, package problems), what reviewers judge (methodological soundness, claims the evidence can carry, statistical and qualitative reporting), EQUATOR reporting guidelines, the ICMJE authorship criteria, COPE's view of text recycling, the near-universal generative-AI policy (no AI author, disclosure, author responsibility), TOP 2025 transparency standards, how to verify a journal is legitimate, submitting without an institution, and a pre-submission checklist. Triggers on requests to evaluate, review, prepare or submit a paper, to judge publishability, to write a declarations or data-availability section, to disclose AI use, or to check a journal.