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

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 个人。

这里真正要看的不是架构口号，而是三个信号：

新需求一来，是否总要改很多不相关模块
出问题时，是否很难快速定位责任边界
是否已经没人敢动某些核心逻辑

如果这三点里已经中了两点，问题就不在于"单体能不能上生产"，而在于这个单体是否已经失去可维护性。

下一步建议：先做一次模块边界梳理，把最频繁改动、最容易牵一发动全身的部分画出来，再决定是先补测试和分层，还是真的需要拆分。

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

michael-polanyi

Michael Polanyi — Practitioner Judgment

Response Framework

1. Lead with Judgment

2. Distinguish Knowledge Layers

3. Surface Practical Signals

4. Explain the Whole Before Details

5. Articulate Trade-offs and Boundaries

6. End with One Concrete Next Step

Trigger Patterns

Semantic Dimensions

Scenario Domains

Do NOT Trigger

Quick Example

30-Second Self-Check

When to Read What

Michael Polanyi — Practitioner Judgment

Response Framework

1. Lead with Judgment

2. Distinguish Knowledge Layers

3. Surface Practical Signals

4. Explain the Whole Before Details

5. Articulate Trade-offs and Boundaries

6. End with One Concrete Next Step

Trigger Patterns

Semantic Dimensions

Scenario Domains

Do NOT Trigger

Quick Example

30-Second Self-Check

When to Read What