How the 'Choice > Effort' Mental Model Applies in Zhangxuefeng-Skill

The 'Choice > Effort' mental model ensures Zhangxuefeng-skill validates career direction before recommending any specific study or job search efforts, preventing wasted energy on misaligned paths.

The Zhangxuefeng-skill repository embeds the principle that "方向错误的努力是浪费，选对赛道比拼命奔跑重要" (wrong-direction effort is waste; choosing the right track matters more than running hard) directly into its AI decision architecture. As one of five core mindsets defined in README.md (lines 332-334), this model forces the skill to complete a "choice-first" validation step before generating any career advice.

What Is the Choice > Effort Mental Model?

The Choice > Effort mental model is defined in the repository's documentation as the foundational belief that selecting the correct direction precedes and outweighs the value of hard work. According to the source code at README.md lines 332-334, this is one of five core mindsets that drive the skill's responses. The model serves as a pre-filter that prevents the AI from suggesting "work harder" strategies when the underlying career path or major selection is fundamentally misaligned with the user's constraints.

Architectural Implementation

The model is not merely documentation; it is baked into three distinct layers of the skill architecture.

Meta-Prompt Layer (SKILL.md)

The SKILL.md file contains the machine-readable definition that the runtime loads, including the mental model table that drives the meta-prompt. As noted in README.md lines 330-334, every generated answer is pre-filtered by this "choose-first" decision step before any content is produced. This means the AI checks its response against the Choice > Effort constraint during the initial prompt processing phase.

Decision Heuristics: The Soul Questioning Method

Concrete tactics in the skill's decision layer enforce this model through Heuristic 1 (灵魂追问法 or "Soul Questioning Method"), documented at README.md lines 40-42. This heuristic repeatedly asks clarifying questions to choose the correct axis before diving into advice. For example, the skill asks: "几分？哪个省？家里做什么的？" (What score? Which province? What do your parents do?) to determine the correct field before recommending any "effort" steps.

Response Generation and Validation

During response generation, the skill applies the model by first selecting the appropriate field, then appending the "Choice > Effort" tag in the footnote. In the example dialogue at README.md lines 95-96, the skill first chooses computer science or electrical engineering as the direction, and only then recommends concrete study steps. Additionally, evaluation tests at lines 94-99 verify that the skill prefers choice over effort, ensuring it never suggests "work harder on the same wrong path" during the quality-validation stage.

Practical Usage and Examples

You can install the skill using the Agent-Skills-compatible runtime:

npx skills add alchaincyf/zhangxuefeng-skill

Once installed, prompt the skill to apply the model:

用张雪峰的视角帮我分析这个专业选择

The skill demonstrates the model in action by interrupting the user to validate direction first. As shown in README.md lines 56-60, the response begins with:

张雪峰    ❯ 停停停，你先别急着说金融。我问你几个问题。
            家里是做金融的吗？爸妈在银行、证券公司、基金公司？
            ...
            560分河南，我给你一个方向：计算机或者电气工程。

Notice how the skill chooses the safer field (computer or electrical engineering) before any "努力" (effort) advice is given.

Why This Model Matters

Applying the Choice > Effort framework provides three concrete benefits:

• Prevents wasted advice: The skill never tells users to "just try harder" on a misaligned career path.
• Accelerates decision making: Front-loading a short "choice" interrogation reduces the number of conversational turns needed to reach useful recommendations.
• Maintains philosophical alignment: The implementation faithfully mirrors Zhang Xuefeng's stance that selecting the right track outweighs running hard on the wrong one.

Key Source Files

• README.md: Contains the five mindsets definition (lines 332-334) and example dialogues (lines 56-60).
• SKILL.md: The machine-readable meta-prompt that the runtime loads.
• references/research/05-decisions.md: Holds deeper research on the Choice > Effort principle and other decision logic.
• examples/demo-conversation.md: Full-length sample conversation showing the model applied end-to-end.

Summary

• The Choice > Effort mental model is defined at README.md lines 332-334 as one of five core mindsets.
• The Soul Questioning Method (Heuristic 1) at lines 40-42 enforces direction-selection before recommendations.
• Response generation applies the model by choosing fields first, then adding effort advice, as seen in the example dialogue at lines 56-60 and 95-96.
• Quality validation tests at lines 94-99 ensure the skill never recommends effort without prior direction validation.
• Install via npx skills add alchaincyf/zhangxuefeng-skill to use this decision framework locally.

Frequently Asked Questions

What does "Choice > Effort" mean in Zhangxuefeng-skill?

In this skill, "Choice > Effort" means the AI must validate that a user's career direction or major selection is appropriate before suggesting any study strategies or hard work. According to the source at README.md lines 332-334, the model reflects the principle that effort in the wrong direction is wasted.

How does the skill prevent wasted effort recommendations?

The skill uses the Soul Questioning Method (灵魂追问法) at README.md lines 40-42 to interrogate the user's context (scores, family background, province) before committing to a recommendation. Additionally, automated evaluation tests at lines 94-99 verify that responses do not suggest working harder on misaligned paths.

Where is the mental model defined in the codebase?

The model is explicitly defined in README.md at lines 332-334 and embedded in the runtime-loaded SKILL.md file. Deeper research on the principle resides in references/research/05-decisions.md, while practical demonstrations appear in examples/demo-conversation.md.

How do I install and use the skill with this mental model?

Install the skill using npx skills add alchaincyf/zhangxuefeng-skill as documented at README.md lines 84-88. Once installed, prompt the skill with career questions; it will automatically apply the Choice > Effort validation by asking clarifying questions before giving advice.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}