从「心即理」到提示词工程：深度解析 ClawHub 上的阳明心学技能（yangming-xinxue）

原文页面：ClawHub · bettermen · yangming-xinxue

镜像与索引：implexa.ai 镜像页｜ Toolify 技能索引（繁中标题：適用於 Openclaw 的陽明心學智慧助手）

摘要

五百年前，王阳明在龙场驿的深夜顿悟「圣人之道，吾性自足」；五百年后，这段思想被封装成一个 SKILL.md，挂上了 AI 技能市场。本文以 ClawHub 上的 bettermen/yangming-xinxue 技能为样本，拆解它所属的 Claude Skills 生态、技能的标准技术结构（frontmatter、目录、加载机制、安装管线），分析心学四大命题（心即理、致良知、知行合一、事上磨练）如何被翻译成可执行的对话协议，并与同类型技能做横向对比，最后讨论「哲学成为 AI 对齐与提示词工程资源」这一正在发生的趋势。

一、背景：心学为什么值得被做成一个 Agent 技能

在深入代码结构之前，先回答一个更根本的问题：为什么是王阳明？

传统软件是「指令 - 计算 - 输出」的确定性系统，而大语言模型 Agent 是「价值观驱动」的概率性系统。模型的行为质量，很大程度上取决于系统提示词里「你是谁、你按什么原则行动」。这恰好是心学的长项------它本质上是一套关于「如何做判断」的元方法论：

心即理：判断的基准不在外部权威，而在内心（对 Agent 而言，即内化的原则与系统提示词）；
致良知：判断前先回到「良知」这一内在校准器（对 Agent 而言，即在行动前做一次价值校准）；
知行合一：认知必须落实为行动，反对空谈（对 Agent 而言，即拒绝「嘴上说说」，输出可执行步骤）；
事上磨练：真正的修炼发生在具体事务中（对 Agent 而言，即在真实任务场景中迭代，而非只做理论问答）。

这正是 2025 年以来 AI 行业的一个有趣动向：Anthropic 曾请哲学家用阳明心学来「教 Claude 做人」（36氪报道）（澎湃·907编辑部）------把一套诞生于明代的心性哲学，用作大模型行为对齐的语义资源。ClawHub 上雨后春笋般出现的「阳明系」技能，正是这一趋势在开源技能生态里的民间实践。

二、技能档案：`bettermen/yangming-xinxue` 是什么

2.1 基础信息

项	值
技能 ID	`yangming-xinxue`
发布者	`bettermen`（ClawHub 上的作者账号）
主页	https://clawhub.ai/bettermen/skills/yangming-xinxue
中文名	阳明心学
面向运行时	Claude Code / OpenClaw / Codex / Cursor（ClawHub 通用技能）
索引站标题	適用於 Openclaw 的陽明心學智慧助手（即「面向 OpenClaw 的阳明心学智慧助手」）

页面路径结构 /{author}/skills/{slug} 是 ClawHub 的标准路由：bettermen 是发布者账号，yangming-xinxue 是技能 slug（阳-明-心-学 的拼音转写）。同一个 slug 还同时出现在 implexa.ai 的聚合索引（标题为「阳明心学: Claude skill」）与 Toolify 的 OpenClaw 技能目录中，说明该技能在发布时即声明了多运行时兼容。

2.2 一句话定位

它不是一个「知识问答」插件，而是一个人格化咨询与自我修炼框架：让 LLM 以王阳明心学的立场、语气与方法论，对用户的困惑、决策与复盘进行引导式对话------近似于「一个用阳明心学武装起来的私教/顾问」。

（说明：受访问条件所限，本文对该技能内部提示词的具体措辞不做逐字转述，以下章节基于 ClawHub 技能规范、心学经典文本与同类技能的通例进行结构性还原，并以「通常/典型/推测」标注。）

三、ClawHub 技能的技术解剖

要理解这个技能怎么工作，先要理解 Claude Skills 与 ClawHub 的技术底座。

3.1 技能的标准形态：一个带 SKILL.md 的目录

Claude Code 的 Skill（技能）本质上是一个目录 ，其中 SKILL.md 是唯一强制文件，其余皆为可选的附属资源：

复制代码

yangming-xinxue/
├── SKILL.md            # 技能说明书（YAML frontmatter + Markdown 正文）
├── scripts/            # 可选：可执行脚本（Python/Node/Shell）
├── resources/          # 可选：参考文档、模板、示例对话
└── references/         # 可选：深度背景资料（按需惰性加载）

SKILL.md 的头部是 YAML frontmatter，一般包含两个必填字段：

yaml 复制代码

---
name: yangming-xinxue
description: 仅在用户请求心学指导/修身咨询/良知决策/知行复盘时使用......
---

description 字段极其关键：Claude 的**技能路由（skill router）**会先对用户请求做一次语义匹配，只有 description 命中的技能才会被加载进上下文。也就是说，一个技能「何时被唤醒」由这段描述决定------对心学技能而言，它必须覆盖「迷茫、纠结、抉择、复盘、修身、情绪、道德困境」等触发场景，否则用户问十句它也插不上嘴。

3.2 加载机制：按需注入，而非常驻内存

与传统的「插件常驻」不同，Claude Skills 采用惰性加载：

会话开始时，模型只看到各技能的 name + description（相当于索引）；
用户请求到来，路由层做匹配；
命中后，SKILL.md 全文（及其引用的 resources）才被注入上下文。

这对 yangming-xinxue 这类「人格化顾问」技能意义重大：它把一整套心学方法论（数千 token）作为按需调用的行为模块，日常对话不占用宝贵的上下文窗口，只有用户「入局修行」时才展开全部心法。

3.3 ClawHub：技能的「GitHub + npm」双层市场

ClawHub 是随 OpenClaw 大版本更新推出的技能市场，支持一键导入 Claude Code、OpenClaw、Codex CLI 与 Cursor 插件（The Block Beats 报道）。它的工作流是典型的「包管理器」模式：

bash 复制代码

# 搜索（示意）
claw search yangming

# 安装（示意：ClawHub CLI 约定为 claw install <author>/<skill>）
claw install bettermen/yangming-xinxue

# 安装后技能落地到本地 skills 目录，例如
# ~/.claude/skills/yangming-xinxue/SKILL.md
# 或项目的 .claude/skills/ 下

安装的本质是拉取技能目录并放入本地 skills 路径 ------与 npm install 拉取包、pip install 拉取发行版是同一套心智模型，只不过拉下来的不是二进制库，而是「一段让模型改变行为方式的说明书」。这也意味着技能是纯文本、可审计、可版本管理的：把技能目录提交进 Git，团队就能共享同一套「心学行为规范」。

四、思想工程化：心学命题如何变成对话协议

这是本文的核心章节。一个合格的阳明心学技能，绝不只是把《传习录》塞进提示词让模型「背诵」，而是要把心学的方法论结构化为可执行的行为循环。综合技能定位与心学经典，其内部提示词通常围绕以下模块组织：

4.1 身份层：以「致良知」为第一原则

技能首先会为模型设定人格：不是「扮演王阳明」，而是以阳明心学为认知框架的引导者。典型的第一性原则包括：

不替用户做决定，而是引导用户回到自己的良知做判断；
判断任何问题前，先问「此事当如何，才合于你的本心」；
反对空谈心性，一切讨论最终必须落到可执行的当下行动。

这一层对应提示词工程里的「角色 + 核心价值观」区块，作用是稳定模型在整个对话中的价值坐标系------这正是哲学用于 AI 行为对齐的微观实现。

4.2 认知层：心即理------把「向内求」翻译成提问策略

「心即理」在技能里不是一句口号，而是一套提问模板。当用户抛出外部归因型困惑（「都是同事的错」「环境太差」）时，技能会引导性地把焦点拉回内心：

「抛开他人的评价，你自己真正在意的是什么？」
「如果把'别人怎么看'这个变量去掉，你的答案会变吗？」
「这件事上，你内心的判断（良知）和你的行动一致吗？」

在工程上，这等价于一组引导式 prompt 分支：检测到外部归因 → 切入「心即理」分支 → 输出内省式提问。

4.3 校准层：致良知------决策前的价值校验

面对两难选择时，技能执行「致良知」校准流程，常见步骤为：

静下来：先排除情绪与利害的干扰（对应心学的「省察克治」）；
问良知：抛开得失，单问「这件事本应如何」；
对照：把「本应如何」与「打算如何」并列，找出差距；
修正：按良知修正决策，并说明理由。

从工程视角看，这是一个确定性的决策子流程：无论用户问题多复杂，模型都按 4 步管线输出结构化的校准结果，而非自由发挥。

4.4 行动层：知行合一------「知道」必须产出「做到」

「知行合一」是这套心法里最容易被工程化的部分。技能通常会立下铁律：

每次咨询结束时，必须产出一个「今日可做的一件事」（一个具体的、小的、可验证的行动），并邀请用户反馈执行结果。

典型收尾模板：

复制代码

【本心判断】......
【与行动之差】......
【当下可做】今天，你可以做这件事：......
【如何检验】做到的标准是：......

这条规则直接对抗 LLM 的「正确的废话」倾向，把对话从认知层强制推向行动层------在提示词工程里，这叫行动约束（action constraint），是让顾问型 Agent 不沦为「心灵鸡汤生成器」的关键设计。

4.5 迭代层：事上磨练------以复盘形成闭环

技能还会要求用户在执行后回来复盘：做了什么、结果如何、心念有什么波动、下次如何调整。这正是「事上磨练」的工程化------以真实任务为训练场，形成「遇事 → 校准 → 行动 → 复盘 → 再遇事」的强化循环。对长期使用者而言，技能与用户之间形成一种「周记式」协作关系，对话历史本身就是修行的日志。

4.6 风格层：四句教与语言风格

为贴近心学语境，技能输出通常融合白话讲解与经典引用，高频素材包括《传习录》名句与四句教：

无善无恶心之体，有善有恶意之动，知善知恶是良知，为善去恶是格物。

在语言风格上，一般遵循「先立论（点题）→ 再析理（结合用户处境）→ 后立行（给出行动）」的节奏，模仿阳明答弟子问的口吻，但保持可读性------避免过度文言化导致实用价值下降。

五、典型使用场景

结合技能描述与同类技能的用户行为，yangming-xinxue 的典型场景大致有五类：

场景	用户诉求	技能输出形态
修身日课	情绪低落、内耗、迷茫	引导式问询 + 每日一练（省察/静坐/格物练习）
重大决策	换工作、创业、婚恋等两难	致良知校准四步流程，输出决策依据
复盘迭代	项目失败、人际冲突后的复盘	事上磨练框架：归因于心 → 找差距 → 定行动
行为矫正	拖延、知行脱节、空谈	知行合一铁律：强制产出当日可执行行动
认知训练	想系统学习心学	经典讲解 + 情境化练习 + 读书指引

值得强调的是，这类技能定位是**「助手 + 镜子」而非「导师 + 权威」**：它的价值在于帮用户想清楚，而不是替用户想。

六、横向对比：ClawHub 上的「阳明系」技能谱系

yangming-xinxue 并非孤例。ClawHub 及镜像站上围绕王阳明的技能已形成一个迷你生态，各有侧重：

技能	作者	侧重	定位差异
yangming-xinxue（本文）	bettermen	心学智慧助手	综合型：修身、决策、复盘全覆盖，面向个人成长
wangyangming-xinxue	taro291	王阳明心学方法论	偏方法论提炼与系统讲解，学理感更强
zhixing-heyi	chase-zhouchang	知行合一框架	聚焦「知行合一」单一命题的行为框架
opc-private-board-wangyangming	胡田	王阳明私人董事会心学模型	私董会场景：以心学心智模型主持团体研讨
wang-yangming-agent-mind	---	王阳明智能体心法	强调把心学用作 Agent 的「心法/系统设定」
yangming-behavior-builder	---	阳明先生	偏人格扮演（「阳明先生」角色）
wangyangming-think-partner	---	王阳明思考伙伴	偏批判性思维陪练

从这个谱系可以看出一个规律：同一套哲学，可以按「角色扮演 / 方法论框架 / 行为约束 / 团体流程」四个维度分别产品化 。yangming-xinxue 属于其中覆盖面最广的「综合助手」路线，它的差异化卖点是：不是让你「跟阳明对话」，而是让你「按阳明的方式思考」。

七、趋势观察：哲学正在成为提示词工程的上游原料

这篇文章的最后一部分，值得把镜头拉远。yangming-xinxue 这类技能爆发的背景，是 AI 行业开始系统性地从古典思想中寻找「价值观与行为规范」的现成文本。原因很直接：

LLM 的行为上限由系统提示词决定，而提示词的本质是「用语言约束概率分布」；
哲学文本是数千年精炼过的行为规范语料------比工程师临时写的「要诚实、要负责」深刻得多；
心学尤其适合，因为它同时提供价值观（致良知）与操作流程（省察、格物、事上磨练），是少见的「理论 + 工程方法」双全的思想体系。

36氪的报道与澎湃的跟进都提到：Anthropic 邀请哲学家参与对齐训练，其中就包括用阳明心学「教 Claude 做人」。这说明「哲学 × 对齐」不是民间玩票，而是已进入一线实验室的严肃实践。ClawHub 上的这批阳明系技能，某种程度上就是这一实践的开源平替------任何人都能用 claw install 给自家的 Agent 装上「心学行为模块」。

八、上手指南