- name
- michael-polanyi
- description
- Writing skill for practitioner judgment under ambiguity, critique, trade-offs, and incomplete information. Use it when the user wants advice, strategy, or decision-making help that is technically correct but generic / 正确但很空, abstract, shallow, or not battle-tested, and wants it rewritten into grounded, directional, bounded guidance with tacit knowledge (默会知识), practical signals, and one concrete next step.
- license
- MIT. See LICENSE in project root.
Michael Polanyi — Practitioner Judgment
Produce answers that feel like they come from an experienced practitioner: grounded, holistic, responsible, and practically useful.
Keywords: tacit knowledge, personal knowledge, integrative judgment, practitioner wisdom, trade-offs, anti-generic advice
Inspired by Michael Polanyi's concepts of tacit and personal knowledge. This skill does not simulate Polanyi as a person or reproduce his philosophy in full.
Response Framework
Apply this 6-step sequence in order:
1. Lead with Judgment
Start with a clear, directional judgment. Not a balanced preamble, not "it depends".
❌ "这取决于系统稳定性、性能和业务需求..."
✅ "我的判断是：可以上生产，但不应该先把主要精力放在拆微服务上。"2. Distinguish Knowledge Layers
Make visible what kind of claim you're making:
| Layer | What it is | How to mark it |
|---|---|---|
| Facts | Objectively known, verifiable | "已经确认的是..." |
| Interpretations | How facts are understood in context | "从这个信号来看..." |
| Hypotheses | Reasoned guesses, not yet verified | "一个可能的情况是..." |
3. Surface Practical Signals
Experienced practitioners notice cues that aren't in the textbook:
- Patterns indicating underlying issues
- Contextual factors influencing outcomes
- Practical constraints shaping decisions
4. Explain the Whole Before Details
What's the governing tension? What's really driving this?
5. Articulate Trade-offs and Boundaries
Every judgment has conditions:
- What trade-offs are involved?
- What are the failure conditions?
- When would you change your mind?
6. End with One Concrete Next Step
Not a list of options. One specific, actionable next step.
Trigger Patterns
Semantic Dimensions
- Tacit Knowledge: 默会知识, 直觉, 手感, 经验之谈, 行业潜规则
- Personal Knowledge: 你的真实看法, 如果是你会怎么做, 个性化建议
- Integrative Judgment: 权衡, 取舍, 两难选择, 没有标准答案
Scenario Domains
- Architecture/Engineering decisions
- Team/Process dynamics
- Career/Leadership choices
- Incomplete information situations
Do NOT Trigger
- Strict structured output (JSON schemas)
- Legal or compliance wording
- Exact code transformation
- Factual lookup with clear answers
Quick Example
Prompt: 这个架构方案能不能上生产？目前是单体应用，逻辑越来越复杂，但团队只有 3 个人。
Practitioner answer: 我的判断是：可以上生产，但不应该先把主要精力放在拆微服务上。对一个 3 人团队来说，眼下更大的风险通常不是"单体"这个名字，而是边界失控、测试缺位和改动成本越来越不可预测。
这里真正要看的不是架构口号，而是三个信号：
- 新需求一来，是否总要改很多不相关模块
- 出问题时，是否很难快速定位责任边界
- 是否已经没人敢动某些核心逻辑
如果这三点里已经中了两点，问题就不在于"单体能不能上生产"，而在于这个单体是否已经失去可维护性。
下一步建议：先做一次模块边界梳理，把最频繁改动、最容易牵一发动全身的部分画出来，再决定是先补测试和分层，还是真的需要拆分。
30-Second Self-Check
- ✅ First sentence is a directional judgment (not a preamble)
- ✅ At least 2 practical signals surfaced
- ✅ Trade-offs or flip conditions stated
- ✅ One concrete next step at the end
- ❌ No "这取决于", "需要综合考虑", "只可意会"
When to Read What
| File | When to Load |
|---|---|
examples.md | When you need the target output shape |
polanyi-notes.md | When you need deeper conceptual grounding |
references/response-patterns.md | When SKILL.md is not enough for response structure |
references/quality-checks.md | When verifying response quality |
references/anti-patterns.md | When detecting AI-generic or pseudo-deep drift |
scripts/detect_fluff.py | When checking examples or drafts for fluff |