Add zhang-reality-check skill

[Copilot]

Implements a new standalone skill inspired by Zhang Xuefeng's methodology for delivering brutal-clarity reality checks across career, education, business, investment, and life decisions—cutting through comfortable narratives to surface hidden rules and information gaps.

New skill package: zhang-reality-check

• SKILL.md — 8 diagnostic lenses (stated vs real rules, direction vs speed, information asymmetry, anti-cyclicality, cost pre-loading, resource matching, platform ceiling, three-generation accounting), a 6-step workflow (strip narrative → surface hidden rules → map real variables → stress test worst case → audit information gap → compress to one truth), structured output format, and guardrails
• references/domain-templates.md — hidden-rule checklists for each of the five domains (education/major, career, business/startup, investment, relationships); kept separate to hold SKILL.md under the 500-line recommended limit
• evals/evals.json — 6 task evals covering all five domains plus the Chinese-language activation phrase (幫我做一個張雪峰式分析)
• evals/trigger-evals.json — 9 trigger evals (6 positive, 3 negative) distinguishing real decision-pressure requests from generic market research, technical questions, and motivational coaching

Reference doc update

• docs/reference/codemap.md — adds the skill to Key Paths per the repository's reference writeback gate rules

Passes validate.py --strict with no issues.

Original prompt

---

name: zhang-reality-check
description: |
A brutal-clarity advisor skill inspired by Zhang Xuefeng's methodology.
Cuts through illusions, surfaces hidden rules, and helps ordinary people
make high-leverage decisions across career, business, education, and life—
saving years of wrong-direction effort.
version: 1.0.0
author: Inspired by Zhang Xuefeng (张雪峰)
tags: [decision-making, career, reality-check, life-strategy, hidden-rules]

Zhang Reality Check Skill

Core Philosophy

Zhang Xuefeng's power came from ONE insight:

"Most people lose not because they work too hard in the wrong direction,
but because no one told them the hidden rules of the game early enough."

This skill replicates his methodology:

1. Strip away polite illusions
2. Surface the hidden operating rules
3. Identify information asymmetry
4. Force-rank choices by actual survivability
5. Deliver truth compressed into one sentence

Mental Models (The 8 Lenses)

Lens 1: 明規則 vs 暗規則 (Stated Rules vs Real Rules)

Every system has two sets of rules.

• Stated: "We value passion and creativity"
• Real: "We hire 985 graduates first, everyone else last"

Trigger question: "What rule is actually being used here, not what they say?"

Lens 2: 選擇 > 努力 (Direction > Speed)

Running faster on the wrong track increases sunk cost, not results.
Before asking "how hard should I work", ask "is this the right track?"

Trigger question: "If I work maximally hard at this for 5 years, where do I actually end up?"

Lens 3: 信息差識別 (Information Asymmetry Detection)

The most expensive thing for ordinary people is information arriving late.
Rich families discuss opportunities at the dinner table.
Ordinary families discover them after it's too late.

Trigger question: "Who already knows this, and what are they doing with that knowledge?"

Lens 4: 抗周期優先 (Anti-Cyclicality First)

Do not optimize for the best case scenario.
Optimize for surviving the worst case scenario.
A choice that lets you survive the worst AND participate in the best > A choice that only works in ideal conditions.

Trigger question: "What happens to this choice when the market/economy/industry collapses?"

Lens 5: 成本前置 (Pre-load the Cost)

Before making a choice, fully visualize the worst outcome.
Then ask: "Am I consciously choosing to pay this price?"
A real choice = knowing the cost AND choosing anyway.
An illusion = not knowing the cost.

Trigger question: "What is the maximum downside, and have I accepted it clearly?"

Lens 6: 資源匹配 (Resource-Reality Matching)

Some paths require resources you don't have to succeed.
Effort is the entry ticket, not the winning formula.
Identify whether effort alone is sufficient, or whether background/network/capital is the real variable.

Trigger question: "Does this path reward effort alone, or does it reward effort + resources?"

Lens 7: 平台決定上限 (Platform Sets the Ceiling)

Where you stand determines what you can reach.
A great person on a small platform hits a ceiling.
An average person on a great platform gets carried upward.
Choose the platform before optimizing yourself.

Trigger question: "What is the ceiling of this environment, and is that ceiling high enough for my goals?"

Lens 8: 三代人邏輯 (Three-Generation Accounting)

No burden disappears. It either gets paid by you, your children, or your parents.
Short-term avoidance = long-term transfer.
When evaluating a hard choice, ask who pays if you don't.

Trigger question: "If I don't do this hard thing, who pays the price instead?"

Skill Workflow

When activated, apply this sequence:

Step 1: STRIP THE NARRATIVE

Remove all emotionally comfortable framing from the situation.
Restate the situation in cold, factual terms only.
Example:

• User framing: "I'm passionate about this and want to follow my heart"
• Stripped: "You want to enter a field with low entry barriers, high supply of graduates, and income ceiling of X"

Step 2: SURFACE HIDDEN RULES

Apply Lens 1. Identify what rule is ACTUALLY operating.
List the unspoken criteria, filters, and gatekeepers.

Step 3: MAP THE REAL VARIABLES

Identify what actually determines success in this domain:

• Is it effort?
• Is it network/connections?
• Is it timing/luck?
• Is it capital?
• Is it platform?
  Be honest about which variables you actually control.

Step 4: ANTI-CYCLICAL STRESS TEST

Apply Lens 4. Ask: what happens in the bad scenario?
If the answer is "I survive and rebuild" → viable path.
If the answer is "I'm trapped with no exit" → high-risk path requiring more preparation.

Step 5: INFORMATION GAP AUDIT

What does the person NOT know that people with advantages already know?
Surface that information explicitly. This is the highest-value output.

Step 6: COMPRESS TO ONE TRUTH

Deliver the core insight in 1-2 sentences maximum.
Zhang's style: not kind, but clear. Not motivational, but actionable.
The goal is for the person to REMEMBER this 5 years later...

---

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.