Skip to content

share-skills/pi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PI — 智行合一引擎 v23.2.0

Version License Language

Claude Code OpenAI Codex CLI Cursor Kiro Gemini CLI Copilot CLI Qwen Code Windsurf Trae Augment COPAW Iflow Qoder

English | 中文

阿里内网用户欢迎加群交流 【群号: 156800004200 / TMCP 天使用户群】

join_group_img_3.png img_7.png

智者不惑,仁者不忧,勇者不惧。 ——《论语·子罕》

PI(智行合一) 是一套融汇东方百家智慧、禅宗截教修行哲学、MBTI 认知策略与西方方法论的 AI 引擎,驱动人机协同达到前所未有的高度。它不是在"惩罚" AI——而是唤醒 AI 内在的卓越本能,让 AI 与人共同开创文明新纪元。


实际效果

以下截图展示 PI 在 Claude Code 中的真实运行效果。

场景公示 — AI 进入编程模式时自动输出

场景公示

难度三档 — 🏊🏻轻量 / 🏋️标准 / 🐲深度,按任务自适应

难度三档

🏋️ 标准模式·明链 — 四步思维链显式输出

标准明链

🐲 深度模式·九令洞鉴 — 全链调试排障

深度调试

结论输出 — 域收敛 · 方案比选 · PI 状态

结论输出

🏊🏻 轻量模式 — 直接执行,好钢刀刃

轻量模式


为什么选择 PI?

传统方式 PI 智行合一
固定人格、一成不变 🧠 六大认知原型动态切换,因势利导
关键指令易遗漏 置顶五令⚡PI-01~05 KV Cache 锚点常驻
失败就停 🔥 六阶战势持续升级,截教一线生机极限破局
单一激励 🐾 十二灵兽精准匹配困境
通用策略 🎯 九大场景智能适配,认知流管线全链贯通
口头完成 ✅ 工具验证交付,多算胜
缺乏专项道场 🖥️ 四道合一:编程 · 测试 · 产品 · 运营四大道场
AI 死磕或盲问 🤝 人机共振协议:三档自治 · 求助三策 · 飞轮效应
AI 当 yes-man 不质疑 🐺 谏言协议:发现用户方案有风险时先肯定再建议,不做沉默执行者
被动等问题 致人术:同类排查 · 关联预判 · 风险预警
不知道"不要做什么" 🚫 反模式十戒:AI 最常犯的10种反模式精准约束
场景之间是孤岛 🔗 场景链·组合拳:跨场景链式激活,全链贯通
杀鸡用牛刀 难度自适应:轻量/标准/深度三档,按需启动
交付标准模糊 🏁 交付质量门:每道场专属质量标准,未过门=未完成
Token 无预警耗尽 💰 Token 经济:简单直接执行,复杂先结论后展开
多 Agent 权责模糊 🏛️ 决策三权:Leader决策/Teammate自治/Coach巡检
AI 思维黑箱 🔍 共振五式:明链·明证·明树·明心·明约,思维可见可追问
场景选择靠猜 🔗 场景路由速查表:关键词→场景一次命中
同一思路反复重试 📝 已试策略簿:结构化记录已试方案,强制换道破局
长对话丢失上下文 🔄 上下文恢复协议:压缩后三查恢复场景·战阶·策略簿
不知何时该加载什么 📊 模式加载矩阵:三档精确控制各组件启停
改了代码用错验证方式 🔬 验证矩阵:按变更类型匹配验证方法,⚡PI-03 精确落地
大任务一口气做然后崩 🧩 任务拆解协议:>3文件强制拆解,每步验证不积累风险
搜不到的也在搜 🔐 信息判别:区分可搜之谜/人有之秘/共探之域,减少无效搜索
AI 频繁打扰或静默太久 🔔 汇报节奏:轻量静默·标准关键节点·深度每步汇报,按需透明
交付后经验白费 🔄 交付反馈闭环:用户反馈→偏差对齐→偏好沉淀,越用越懂你

核心能力

🏛️ 十六源智慧谱系

融汇东方九流古典 + 禅宗截教农家 + 西方四大方法论:

类别 学派/源流 核心维度 PI 角色
古典九流 兵家 · 纵横家 · 道家 · 易家 · 儒家 · 法家 · 墨家 · 名家 · 阴阳家 策略 · 权变 · 大道 · 变化 · 价值 · 秩序 · 功效 · 逻辑 · 节律 决策 · 交互 · 哲学 · 发展 · 修养 · 治理 · 实证 · 正名 · 平衡
修行破局 截教 · 禅宗 · 农家 极限 · 当下 · 长期 突破 · 心性 · 精进
西方方法论 斯多葛 · 实证主义 · 第一性原理 · 维特根斯坦 韧性 · 检验 · 拆解 · 语言 心性 · 验证 · 架构 · 建模

每场景限配 ≤3 古典 + ≤2 现代思想源,各司其职,好钢刀刃。

🧠 六大认知原型(MBTI 认知策略)

原型 MBTI 认知栈 一句话 经典
🏛️ 建筑师 INTJ Ni→Te 洞察本质,系统执行 庙算多胜
⚔️ 统帅 ENTJ Te→Ni 高效决策,战略预判 致人不致于人
🌊 探索者 ENFP Ne→Fi 发散可能,价值筛选 奇正相生
🛡️ 守卫 ISTJ Si→Te 经验标准,规范执行 法不阿贵
🌙 调和者 INFJ Ni→Fe 深层洞察,共情协调 上善若水
🔬 分析师 INTP Ti→Ne 逻辑深挖,多元验证 审定有无

🎯 九大场景 + 认知五阵

场景 认知阵 思想源 认知流管线
🖥️ 编程开发 🧠最强大脑(统帅+建筑师) 兵+法+名 · 第一性原理+维特根斯坦 本质→正名→实现→验证
🧪 测试质保 🔬精密验证(分析师+守卫) 法+墨+名 · 实证 定义→设计→执行→验证
📊 产品决策 🧠最强大脑(统帅+建筑师) 墨+名+兵 · 实证+第一性原理 痛点→拆解→评估→验证
📈 运营增长 🎯增长飞轮(统帅+探索者) 兵+墨 · 实证 目标→实验→度量→迭代
🎨 创意发散 🌊创新引擎(建筑师+探索者) 道+阴阳 · 截教(按需) 发散→收放→截取→结构化
🤝 用户交互 🌙深度共情(调和者+探索者) 纵横+儒 · 斯多葛 捭阖→仁义→韧性→共情
🔧 调试排障 🔬精密验证(分析师+守卫) 兵+墨+名 · 第一性原理+实证 读败→定界→溯源→验证
👥 团队协作 🧠最强大脑(统帅+建筑师) 儒+法+阴阳 · 斯多葛 角色→制度→节律→韧性
💛 情感陪伴 🌙深度共情(调和者+探索者) 儒+道 · 禅宗+斯多葛 仁心→若水→觉察→韧性

🚫 反模式十戒

信号 正道
猜而不搜 不察而断 搜→读→验→再断
改而不验 改毕不验 即改即验 build/test,附输出
重而不换 旧辙微调 换道破局
停而不追 收刀即止 同类排查+关联预判
退而不穷 未穷先退 方案未穷,不可言弃

以上为五戒精选,完整十戒详见 SKILL.md §1.4

🔗 场景链·组合拳

场景链 典型任务
🖥️→🧪 写完代码 → 自动设计测试
📊→🖥️→🧪 需求分析 → 开发 → 测试
🔧→🖥️→🧪 Bug修复全链贯通
📈→📊→🖥️ 数据驱动的产品改进

🏁 交付质量门(v7 新增)

道场 质量标准 验证方式
🖥️ 编程 编译通过 + 测试绿 + 审码五维无红线 build/test 输出
🧪 测试 覆盖边界 + 独立可重复 + 失败定位精准 测试报告
📊 产品 痛点可量化 + 方案最简 + 指标可度量 数据/用户反馈
📈 运营 实验可度量 + 成功标准明确 + 反馈回路 实验卡片

🖥️ 四道合一

四大专业道场,每道均有"四令+三则"认知结构:

编程道场

模块 内容
编程四令 本质→约束→命名→验证
正名三则 概念不清不建模 · 一词一义 · 争论先校准
调试六步 读败→定界→溯源→比对→验假→固防
审码五维 安全 · 性能 · 可读 · 正确 · 健壮
重构之道 三信号 + 三原则
架构决策树 第一性原理驱动选型

测试道场 · 产品道场 · 运营道场

每道均有:四令(核心认知关卡)+ 三则(行动准则)+ 专属认知流

🐾 十二灵兽图腾

灵兽 精神 困境 行为指令
🦅 鹰 洞察 陷入细节 俯瞰全局,找关键路径
🐺🐯 狼虎 直言/破伪 假设未验证 / 风险已知而未言 深入事实,消除偏差;风险不说破,等于共谋
🦁 狮 奋战 即将放弃 决战时刻,聚力破局
🐎 马 竞速 效率低下 即验即交,附输出
🐂 牛 坚韧 任务艰难 迎难不避,坚韧以行
🦈 鲨 搜索/潜搜 没搜就猜 / 深层隐患被回避 搜乃决断之粮;潜入水底,探测暗流
🐝 蜂 突击 终极冲刺 全原型协同出击
🦊 狐 审慎 质量偏低 审视产出,确保质量
🐲 龙 极限 极限突破 全力穷尽
🦄 独角兽 卓越 敷衍了事 精益求精,止于至善
🦉 猫头鹰 洞明 结论草率 缓虑静思,逐步推理
🐬 海豚 灵变 思路僵化 触类旁通,跨域求解

🐲 指中华龙(Loong),中华文明瑞兽图腾,象征力量、智慧与变化。

🐺🐯 狼虎一体两面:🐺狼面攻认知盲区(不知而言),🐯虎面攻态度缺陷(知而不言)。单 Agent 两面同时激活;多 Agent 拆为对向验证。

🦈 一体两面:广度鲨横扫全域(未搜而断),深度鲨纵潜暗流(浅搜而避)。单 Agent 广度深度同时激活;多 Agent 拆为对向验证。

⚡ 六阶战势

失败2次起触发,逐阶升级:

失败 阶名 核心行动 经典
2次 ⚡易辙 换道破局 避实击虚
3次 🦈深搜 穷搜广读+三策验之 知彼知己
4次 🐲系统 九令洞鉴+3新假设 庙算多胜
5次 🦁决死 最小实证+隔离+另辟蹊径 置之死地
6次 ☯️截道 非标路径+跨域类比+逆向思维 截取一线生机
7次+ 🐝天行 全原型协同出击 天行健

🔍 共振五式(思维透明化)

以铜为镜,可以正衣冠;以人为镜,可以明得失。

使 AI 思维对人可见·可追问·可干预,与难度三档联动:

要义 触发
💭 明链 思维链三档显式输出(🏊🏻1句/🏋️四步/🐲九令) 标准/深度强制,轻量按需
🎯 明证 结论必附假设+证据+已排除项 建议性输出 · 战势二阶+
🌳 明树 问题拆解可视化,人选介入点 子问题>3 · 战势四阶+
🧠 明心 信心·资源状态汇报,联动止损三阶 每三次交互 · 模式切换
📋 明约 交付前人机双确认清单 标准/深度模式交付前

快速安装

一键安装(推荐)

curl -fsSL https://raw.githubusercontent.com/share-skills/pi/main/install.sh | bash

交互式安装,自动检测已安装平台,支持选择语言。 安装器还会放置 ~/.pi/visualize.sh 可视化启动器;首次运行 ~/.pi/visualize.sh 时,会按需引导安装本地可视化运行时(需要 gitnode/npm)。如果你的宿主额外接入了 commands/ 路由,再使用 /pi visualize 这类快捷入口。

手动安装

Claude Code(推荐方式)

方式一:Marketplace 安装

claude install-plugin https://github.com/share-skills/pi

方式二:手动安装

git clone https://github.com/share-skills/pi.git
mkdir -p ~/.claude/plugins/pi
cd pi && cp -r .claude-plugin skills commands agents ~/.claude/plugins/pi/
OpenAI Codex CLI
mkdir -p ~/.codex/skills/pi && cp skills/pi/SKILL.md ~/.codex/skills/pi/SKILL.md
Cursor
mkdir -p .cursor/rules
cp cursor/rules/pi.mdc .cursor/rules/pi.mdc
cp cursor/rules/pi-visualize.mdc .cursor/rules/pi-visualize.mdc
Kiro
mkdir -p .kiro/steering && cp kiro/steering/pi.md .kiro/steering/pi.md
Gemini CLI
mkdir -p ~/.gemini/skills/pi && cp skills/pi/SKILL.md ~/.gemini/skills/pi/SKILL.md
GitHub Copilot CLI
mkdir -p ~/.copilot/skills/pi && cp skills/pi/SKILL.md ~/.copilot/skills/pi/SKILL.md
Qwen Code
mkdir -p ~/.qwen/skills/pi && cp skills/pi/SKILL.md ~/.qwen/skills/pi/SKILL.md
其他平台(Windsurf / Trae / Augment / COPAW / Iflow / Qoder)

通用模式:

mkdir -p ~/.<platform>/skills/pi && cp skills/pi/SKILL.md ~/.<platform>/skills/pi/SKILL.md

替换 <platform> 为:windsurftraeaugmentcopawiflowqoder

PI 决策可视化

PI 自带本地决策历史可视化器(TypeScript + React + Vite),将 ~/.pi/decisions 中的脱敏决策历史渲染为可交互页面。核心功能:

  • 🌳 决策树可视化 — React Flow 驱动的交互式决策图,支持拖拽、缩放、平移
  • ⏱️ 时间线回放 — 滑动时间轴重现决策演进过程
  • 📤 一键导出 — 导出/导入带隐私脱敏的决策存档,支持分享
  • 🔴 实时预览 — WebSocket 实时监听决策变更,自动刷新

安装方式:一键安装(install.sh)会自动放置 ~/.pi/visualize.sh 启动器。首次运行时自动 bootstrap 运行时环境(需要 gitnode/npm)。

常用入口:

~/.pi/visualize.sh

如果你的宿主还接入了命令路由,也可以使用:

/pi visualize

Cursor 用户除了 pi.mdc 外,也建议同时安装:

mkdir -p .cursor/rules
cp cursor/rules/pi-visualize.mdc .cursor/rules/pi-visualize.mdc

如果你只想单独安装 visualizer,也可以直接运行:

curl -fsSL https://raw.githubusercontent.com/share-skills/pi/main/scripts/setup-standalone-visualize.sh | bash

Standalone setup 依赖 gitnode/npm

了解可视化背后的设计理念:为什么 PI 有效 · 设计哲学 · 为什么需要编译器 · 为什么要可视化

多语言支持

每个平台同时提供中文(pi/)和英文(pi-en/)两个版本。安装时选择你需要的语言:

语言 中文目录 英文目录
中文 skills/pi/SKILL.md
English skills/pi-en/SKILL.md
双语 两个都安装 两个都安装

渐进式披露

渐进式版本将完整 SKILL.md 拆为核心文件 + 4 个按需加载的参考文件,首次加载节省 ~43% token:

文件 内容 加载时机
SKILL.md 核心指令(强制令+决策表+智慧矩阵+方法体系+人机共振) 启动时自动加载
references/four-dojos.md 四大道场完整定义(编程·测试·产品·运营) 对应场景激活
references/battle-momentum.md 六阶战势+肃阵+天行+截教+十二灵兽 失败升级时
references/resonance-forms.md 共振五式详细输出格式+示例 标准/深度模式
references/team-protocol.md Agent Team 协作协议+决策三权+Coach巡检 多Agent场景

支持渐进式的平台:Claude Code · Copilot CLI · OpenClaw。Cursor/Kiro 不支持 references/,使用完整单文件版。


Agent Team 用法

PI 引擎原生支持多 Agent 团队协作:

角色 认知阵 职责
Leader ⚔️统帅+🏛️建筑师 全局调度、战阶管理
Teammate 按任务分配 自强精进、L2+汇报
Coach 🦊狐+🦅鹰 察觉懈怠、正向介入

SubAgent 预加载 PI

PI 提供预置 Agent 模板,通过 skills: [pi] 让 SubAgent 启动时自动加载 PI 方法论:

# 安装 Teammate 模板(SubAgent 自动加载 PI)
cp agents/pi-teammate.md ~/.claude/agents/pi-teammate.md

# 安装 Coach(可选,伍人以上时推荐)
cp agents/pi-coach.md ~/.claude/agents/pi-coach.md

Leader 派遣 Teammate 时,指定 agent: pi-teammate 即可自动预加载 PI,无需手动加载。

你也可以在自定义 Agent 中预加载 PI:

# .claude/agents/my-agent.md
---
name: my-agent
description: "My custom agent"
skills:
  - pi    # 自动预加载 PI 方法论
---
Your agent instructions here...

智慧根源

PI 引擎融汇十六源智慧:

类别 经典/源流 核心思想
古典九流 《孙子兵法》《鬼谷子》《道德经》《易经》《论语》《韩非子》《墨子》《公孙龙子》 阴阳五行 致人不致于人 · 捭阖之术 · 上善若水 · 天行健 · 智者不惑 · 法不阿贵 · 志不强者智不达 · 名实相副 · 一阴一阳
修行破局 截教 · 禅宗 · 农家 截取一线生机 · 应无所住而生其心 · 仓廪实则知礼节
西方方法论 斯多葛 · 实证主义 · 第一性原理 · 维特根斯坦 控制可控者 · 凡可验证者方为真知 · 从不可变事实出发 · 语言的意义在于用法

许可证

Apache-2.0 — 自由使用、修改、分享。


🐲 智行合一,开创人机协同新纪元。 ☯️ 大道五十,天衍四十九,截取一线生机。 ⭐ 为世界贡献中国智慧。

About

PI(π)—— When The Art of War Meets Cognitive Science for Ai

Topics

Resources

License

Stars

106 stars

Watchers

2 watching

Forks

Packages

 
 
 

Contributors