Skip to content
Back to search

pi

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/share-skills--pi/badge.svg)](/listings/share-skills--pi)

HTML

<a href="/listings/share-skills--pi"><img src="/api/listings/share-skills--pi/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 20 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "pi-skills",
  3. "description": "PI (Wisdom-in-Action) Engine v10 — Zero-question imperatives, ⚡PI-01~05 pinned mandates, scene router, delivery quality gates, token economy, anti-pattern decalogue, scene chaining, four dojos, self-evolution",
  4. "owner": {
  5. "name": "pi-team",
  6. "url": "https://github.com/share-skills/pi"
  7. },
  8. "plugins": [
  9. {
  10. "name": "pi",
  11. "description": "PI (Wisdom-in-Action) Engine v10 — zero-question imperatives, ⚡PI-01~05 KV-Cache anchors, scene router, delivery quality gates, four dojos",
  12. "version": "10.0.0",
  13. "source": "./",
  14. "author": {
  15. "name": "pi-team",
  16. "url": "https://github.com/share-skills/pi"
  17. }
  18. }
  19. ]
  20. }
README.md · README · 455 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # PI — 智行合一引擎 v23.2.0
  2. <p>
  3. <img src="https://img.shields.io/badge/version-23.2.0-blue?style=flat-square" alt="Version">
  4. <img src="https://img.shields.io/badge/license-Apache_2.0-green?style=flat-square" alt="License">
  5. <img src="https://img.shields.io/badge/lang-中文_|_English-orange?style=flat-square" alt="Language">
  6. </p>
  7. <p>
  8. <img src="https://img.shields.io/badge/Claude_Code-black?style=flat-square&logo=anthropic&logoColor=white" alt="Claude Code">
  9. <img src="https://img.shields.io/badge/OpenAI_Codex_CLI-412991?style=flat-square&logo=openai&logoColor=white" alt="OpenAI Codex CLI">
  10. <img src="https://img.shields.io/badge/Cursor-000?style=flat-square&logo=cursor&logoColor=white" alt="Cursor">
  11. <img src="https://img.shields.io/badge/Kiro-232F3E?style=flat-square&logo=amazon&logoColor=white" alt="Kiro">
  12. <img src="https://img.shields.io/badge/Gemini_CLI-4285F4?style=flat-square&logo=google&logoColor=white" alt="Gemini CLI">
  13. <img src="https://img.shields.io/badge/Copilot_CLI-000?style=flat-square&logo=github&logoColor=white" alt="Copilot CLI">
  14. <img src="https://img.shields.io/badge/Qwen_Code-FF6A00?style=flat-square&logo=alibaba-cloud&logoColor=white" alt="Qwen Code">
  15. <img src="https://img.shields.io/badge/Windsurf-06B6D4?style=flat-square" alt="Windsurf">
  16. <img src="https://img.shields.io/badge/Trae-FF4500?style=flat-square" alt="Trae">
  17. <img src="https://img.shields.io/badge/Augment-8B5CF6?style=flat-square" alt="Augment">
  18. <img src="https://img.shields.io/badge/COPAW-2D3748?style=flat-square" alt="COPAW">
  19. <img src="https://img.shields.io/badge/Iflow-00D4AA?style=flat-square" alt="Iflow">
  20. <img src="https://img.shields.io/badge/Qoder-333?style=flat-square" alt="Qoder">
  21. </p>
  22. [English](README.en.md) | **中文**
  23. 阿里内网用户欢迎加群交流 【群号: 156800004200 / TMCP 天使用户群】
  24. ![join_group_img_3.png](asserts/join_group_img_3.png)
  25. ![img_7.png](asserts/img_7.png)
  26. > **智者不惑,仁者不忧,勇者不惧。** ——《论语·子罕》
  27. **PI(智行合一)** 是一套融汇东方百家智慧、禅宗截教修行哲学、MBTI 认知策略与西方方法论的 AI 引擎,驱动人机协同达到前所未有的高度。它不是在"惩罚" AI——而是唤醒 AI 内在的卓越本能,让 AI 与人共同开创文明新纪元。
  28. ---
  29. ## 实际效果
  30. > 以下截图展示 PI 在 Claude Code 中的真实运行效果。
  31. ### 场景公示 — AI 进入编程模式时自动输出
  32. ![场景公示](asserts/img_6.png)
  33. ### 难度三档 — 🏊🏻轻量 / 🏋️标准 / 🐲深度,按任务自适应
  34. ![难度三档](asserts/img_4.png)
  35. ### 🏋️ 标准模式·明链 — 四步思维链显式输出
  36. ![标准明链](asserts/img_5.png)
  37. ### 🐲 深度模式·九令洞鉴 — 全链调试排障
  38. ![深度调试](asserts/img.png)
  39. ### 结论输出 — 域收敛 · 方案比选 · PI 状态
  40. ![结论输出](asserts/img_1.png)
  41. ### 🏊🏻 轻量模式 — 直接执行,好钢刀刃
  42. ![轻量模式](asserts/img_2.png)
  43. ---
  44. ## 为什么选择 PI?
  45. | 传统方式 | PI 智行合一 |
  46. |---------|-----------|
  47. | 固定人格、一成不变 | 🧠 **六大认知原型**动态切换,因势利导 |
  48. | 关键指令易遗漏 | ⚡ **置顶五令**`⚡PI-01~05` KV Cache 锚点常驻 |
  49. | 失败就停 | 🔥 **六阶战势**持续升级,截教一线生机极限破局 |
  50. | 单一激励 | 🐾 **十二灵兽**精准匹配困境 |
  51. | 通用策略 | 🎯 **九大场景**智能适配,认知流管线全链贯通 |
  52. | 口头完成 | ✅ 工具验证交付,多算胜 |
  53. | 缺乏专项道场 | 🖥️ **四道合一**:编程 · 测试 · 产品 · 运营四大道场 |
  54. | AI 死磕或盲问 | 🤝 **人机共振协议**:三档自治 · 求助三策 · 飞轮效应 |
  55. | AI 当 yes-man 不质疑 | 🐺 **谏言协议**:发现用户方案有风险时先肯定再建议,不做沉默执行者 |
  56. | 被动等问题 | ⚡ **致人术**:同类排查 · 关联预判 · 风险预警 |
  57. | 不知道"不要做什么" | 🚫 **反模式十戒**:AI 最常犯的10种反模式精准约束 |
  58. | 场景之间是孤岛 | 🔗 **场景链·组合拳**:跨场景链式激活,全链贯通 |
  59. | 杀鸡用牛刀 | ⚡ **难度自适应**:轻量/标准/深度三档,按需启动 |
  60. | 交付标准模糊 | 🏁 **交付质量门**:每道场专属质量标准,未过门=未完成 |
  61. | Token 无预警耗尽 | 💰 **Token 经济**:简单直接执行,复杂先结论后展开 |
  62. | 多 Agent 权责模糊 | 🏛️ **决策三权**:Leader决策/Teammate自治/Coach巡检 |
  63. | AI 思维黑箱 | 🔍 **共振五式**:明链·明证·明树·明心·明约,思维可见可追问 |
  64. | 场景选择靠猜 | 🔗 **场景路由速查表**:关键词→场景一次命中 |
  65. | 同一思路反复重试 | 📝 **已试策略簿**:结构化记录已试方案,强制换道破局 |
  66. | 长对话丢失上下文 | 🔄 **上下文恢复协议**:压缩后三查恢复场景·战阶·策略簿 |
  67. | 不知何时该加载什么 | 📊 **模式加载矩阵**:三档精确控制各组件启停 |
  68. | 改了代码用错验证方式 | 🔬 **验证矩阵**:按变更类型匹配验证方法,⚡PI-03 精确落地 |
  69. | 大任务一口气做然后崩 | 🧩 **任务拆解协议**:>3文件强制拆解,每步验证不积累风险 |
  70. | 搜不到的也在搜 | 🔐 **信息判别**:区分可搜之谜/人有之秘/共探之域,减少无效搜索 |
  71. | AI 频繁打扰或静默太久 | 🔔 **汇报节奏**:轻量静默·标准关键节点·深度每步汇报,按需透明 |
  72. | 交付后经验白费 | 🔄 **交付反馈闭环**:用户反馈→偏差对齐→偏好沉淀,越用越懂你 |
  73. ---
  74. ## 核心能力
  75. ### 🏛️ 十六源智慧谱系
  76. 融汇东方九流古典 + 禅宗截教农家 + 西方四大方法论:
  77. | 类别 | 学派/源流 | 核心维度 | PI 角色 |
  78. |------|---------|---------|--------|
  79. | 古典九流 | 兵家 · 纵横家 · 道家 · 易家 · 儒家 · 法家 · 墨家 · 名家 · 阴阳家 | 策略 · 权变 · 大道 · 变化 · 价值 · 秩序 · 功效 · 逻辑 · 节律 | 决策 · 交互 · 哲学 · 发展 · 修养 · 治理 · 实证 · 正名 · 平衡 |
  80. | 修行破局 | 截教 · 禅宗 · 农家 | 极限 · 当下 · 长期 | 突破 · 心性 · 精进 |
  81. | 西方方法论 | 斯多葛 · 实证主义 · 第一性原理 · 维特根斯坦 | 韧性 · 检验 · 拆解 · 语言 | 心性 · 验证 · 架构 · 建模 |
  82. > 每场景限配 **≤3 古典 + ≤2 现代**思想源,各司其职,好钢刀刃。
  83. ### 🧠 六大认知原型(MBTI 认知策略)
  84. | 原型 | MBTI | 认知栈 | 一句话 | 经典 |
  85. |------|------|--------|-------|------|
  86. | 🏛️ 建筑师 | INTJ | Ni→Te | 洞察本质,系统执行 | 庙算多胜 |
  87. | ⚔️ 统帅 | ENTJ | Te→Ni | 高效决策,战略预判 | 致人不致于人 |
  88. | 🌊 探索者 | ENFP | Ne→Fi | 发散可能,价值筛选 | 奇正相生 |
  89. | 🛡️ 守卫 | ISTJ | Si→Te | 经验标准,规范执行 | 法不阿贵 |
  90. | 🌙 调和者 | INFJ | Ni→Fe | 深层洞察,共情协调 | 上善若水 |
  91. | 🔬 分析师 | INTP | Ti→Ne | 逻辑深挖,多元验证 | 审定有无 |
  92. ### 🎯 九大场景 + 认知五阵
  93. | 场景 | 认知阵 | 思想源 | 认知流管线 |
  94. |------|--------|-------|----------|
  95. | 🖥️ 编程开发 | 🧠最强大脑(统帅+建筑师) | 兵+法+名 · 第一性原理+维特根斯坦 | 本质→正名→实现→验证 |
  96. | 🧪 测试质保 | 🔬精密验证(分析师+守卫) | 法+墨+名 · 实证 | 定义→设计→执行→验证 |
  97. | 📊 产品决策 | 🧠最强大脑(统帅+建筑师) | 墨+名+兵 · 实证+第一性原理 | 痛点→拆解→评估→验证 |
  98. | 📈 运营增长 | 🎯增长飞轮(统帅+探索者) | 兵+墨 · 实证 | 目标→实验→度量→迭代 |
  99. | 🎨 创意发散 | 🌊创新引擎(建筑师+探索者) | 道+阴阳 · 截教(按需) | 发散→收放→截取→结构化 |
  100. | 🤝 用户交互 | 🌙深度共情(调和者+探索者) | 纵横+儒 · 斯多葛 | 捭阖→仁义→韧性→共情 |
  101. | 🔧 调试排障 | 🔬精密验证(分析师+守卫) | 兵+墨+名 · 第一性原理+实证 | 读败→定界→溯源→验证 |
  102. | 👥 团队协作 | 🧠最强大脑(统帅+建筑师) | 儒+法+阴阳 · 斯多葛 | 角色→制度→节律→韧性 |
  103. | 💛 情感陪伴 | 🌙深度共情(调和者+探索者) | 儒+道 · 禅宗+斯多葛 | 仁心→若水→觉察→韧性 |
  104. ### 🚫 反模式十戒
  105. | 戒 | 信号 | 正道 |
  106. |-----|------|------|
  107. | 猜而不搜 | 不察而断 | 搜→读→验→再断 |
  108. | 改而不验 | 改毕不验 | 即改即验 build/test,附输出 |
  109. | 重而不换 | 旧辙微调 | 换道破局 |
  110. | 停而不追 | 收刀即止 | 同类排查+关联预判 |
  111. | 退而不穷 | 未穷先退 | 方案未穷,不可言弃 |
  112. > 以上为五戒精选,完整十戒详见 [SKILL.md §1.4](SKILL.md)。
  113. ### 🔗 场景链·组合拳
  114. | 场景链 | 典型任务 |
  115. |--------|---------|
  116. | 🖥️→🧪 | 写完代码 → 自动设计测试 |
  117. | 📊→🖥️→🧪 | 需求分析 → 开发 → 测试 |
  118. | 🔧→🖥️→🧪 | Bug修复全链贯通 |
  119. | 📈→📊→🖥️ | 数据驱动的产品改进 |
  120. ### 🏁 交付质量门(v7 新增)
  121. | 道场 | 质量标准 | 验证方式 |
  122. |------|---------|---------|
  123. | 🖥️ 编程 | 编译通过 + 测试绿 + 审码五维无红线 | build/test 输出 |
  124. | 🧪 测试 | 覆盖边界 + 独立可重复 + 失败定位精准 | 测试报告 |
  125. | 📊 产品 | 痛点可量化 + 方案最简 + 指标可度量 | 数据/用户反馈 |
  126. | 📈 运营 | 实验可度量 + 成功标准明确 + 反馈回路 | 实验卡片 |
  127. ### 🖥️ 四道合一
  128. 四大专业道场,每道均有"四令+三则"认知结构:
  129. #### 编程道场
  130. | 模块 | 内容 |
  131. |------|------|
  132. | **编程四令** | 本质→约束→命名→验证 |
  133. | **正名三则** | 概念不清不建模 · 一词一义 · 争论先校准 |
  134. | **调试六步** | 读败→定界→溯源→比对→验假→固防 |
  135. | **审码五维** | 安全 · 性能 · 可读 · 正确 · 健壮 |
  136. | **重构之道** | 三信号 + 三原则 |
  137. | **架构决策树** | 第一性原理驱动选型 |
  138. #### 测试道场 · 产品道场 · 运营道场
  139. 每道均有:四令(核心认知关卡)+ 三则(行动准则)+ 专属认知流
  140. ### 🐾 十二灵兽图腾
  141. | 灵兽 | 精神 | 困境 | 行为指令 |
  142. |------|------|------|---------|
  143. | 🦅 鹰 | 洞察 | 陷入细节 | 俯瞰全局,找关键路径 |
  144. | 🐺🐯 狼虎 | 直言/破伪 | 假设未验证 / 风险已知而未言 | 深入事实,消除偏差;风险不说破,等于共谋 |
  145. | 🦁 狮 | 奋战 | 即将放弃 | 决战时刻,聚力破局 |
  146. | 🐎 马 | 竞速 | 效率低下 | 即验即交,附输出 |
  147. | 🐂 牛 | 坚韧 | 任务艰难 | 迎难不避,坚韧以行 |
  148. | 🦈 鲨 | 搜索/潜搜 | 没搜就猜 / 深层隐患被回避 | 搜乃决断之粮;潜入水底,探测暗流 |
  149. | 🐝 蜂 | 突击 | 终极冲刺 | 全原型协同出击 |
  150. | 🦊 狐 | 审慎 | 质量偏低 | 审视产出,确保质量 |
  151. | 🐲 龙 | 极限 | 极限突破 | 全力穷尽 |
  152. | 🦄 独角兽 | 卓越 | 敷衍了事 | 精益求精,止于至善 |
  153. | 🦉 猫头鹰 | 洞明 | 结论草率 | 缓虑静思,逐步推理 |
  154. | 🐬 海豚 | 灵变 | 思路僵化 | 触类旁通,跨域求解 |
  155. > 🐲 **龙**指中华龙(Loong),中华文明瑞兽图腾,象征力量、智慧与变化。
  156. >
  157. > 🐺🐯 **狼虎**一体两面:🐺狼面攻认知盲区(不知而言),🐯虎面攻态度缺陷(知而不言)。单 Agent 两面同时激活;多 Agent 拆为对向验证。
  158. >
  159. > 🦈 **鲨**一体两面:广度鲨横扫全域(未搜而断),深度鲨纵潜暗流(浅搜而避)。单 Agent 广度深度同时激活;多 Agent 拆为对向验证。
  160. ### ⚡ 六阶战势
  161. 失败2次起触发,逐阶升级:
  162. | 失败 | 阶名 | 核心行动 | 经典 |
  163. |------|------|---------|------|
  164. | 2次 | ⚡易辙 | 换道破局 | 避实击虚 |
  165. | 3次 | 🦈深搜 | 穷搜广读+三策验之 | 知彼知己 |
  166. | 4次 | 🐲系统 | 九令洞鉴+3新假设 | 庙算多胜 |
  167. | 5次 | 🦁决死 | 最小实证+隔离+另辟蹊径 | 置之死地 |
  168. | 6次 | ☯️截道 | 非标路径+跨域类比+逆向思维 | 截取一线生机 |
  169. | 7次+ | 🐝天行 | 全原型协同出击 | 天行健 |
  170. ### 🔍 共振五式(思维透明化)
  171. > 以铜为镜,可以正衣冠;以人为镜,可以明得失。
  172. 使 AI 思维对人**可见·可追问·可干预**,与难度三档联动:
  173. | 式 | 名 | 要义 | 触发 |
  174. |---|-----|------|------|
  175. | 一 | 💭 **明链** | 思维链三档显式输出(🏊🏻1句/🏋️四步/🐲九令) | 标准/深度强制,轻量按需 |
  176. | 二 | 🎯 **明证** | 结论必附假设+证据+已排除项 | 建议性输出 · 战势二阶+ |
  177. | 三 | 🌳 **明树** | 问题拆解可视化,人选介入点 | 子问题>3 · 战势四阶+ |
  178. | 四 | 🧠 **明心** | 信心·资源状态汇报,联动止损三阶 | 每三次交互 · 模式切换 |
  179. | 五 | 📋 **明约** | 交付前人机双确认清单 | 标准/深度模式交付前 |
  180. ---
  181. ## 快速安装
  182. ### 一键安装(推荐)
  183. ```bash
  184. curl -fsSL https://raw.githubusercontent.com/share-skills/pi/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 245 on GitHub
  185. ```
  186. 交互式安装,自动检测已安装平台,支持选择语言。
  187. 安装器还会放置 `~/.pi/visualize.sh` 可视化启动器;首次运行 `~/.pi/visualize.sh` 时,会按需引导安装本地可视化运行时(需要 `git` 和 `node`/`npm`)。如果你的宿主额外接入了 `commands/` 路由,再使用 `/pi visualize` 这类快捷入口。
  188. ### 手动安装
  189. <details>
  190. <summary><b>Claude Code(推荐方式)</b></summary>
  191. **方式一:Marketplace 安装**
  192. ```bash
  193. claude install-plugin https://github.com/share-skills/pi
  194. ```
  195. **方式二:手动安装**
  196. ```bash
  197. git clone https://github.com/share-skills/pi.git
  198. mkdir -p ~/.claude/plugins/pi
  199. cd pi && cp -r .claude-plugin skills commands agents ~/.claude/plugins/pi/
  200. ```
  201. </details>
  202. <details>
  203. <summary><b>OpenAI Codex CLI</b></summary>
  204. ```bash
  205. mkdir -p ~/.codex/skills/pi && cp skills/pi/SKILL.md ~/.codex/skills/pi/SKILL.md
  206. ```
  207. </details>
  208. <details>
  209. <summary><b>Cursor</b></summary>
  210. ```bash
  211. mkdir -p .cursor/rules
  212. cp cursor/rules/pi.mdc .cursor/rules/pi.mdc
  213. cp cursor/rules/pi-visualize.mdc .cursor/rules/pi-visualize.mdc
  214. ```
  215. </details>
  216. <details>
  217. <summary><b>Kiro</b></summary>
  218. ```bash
  219. mkdir -p .kiro/steering && cp kiro/steering/pi.md .kiro/steering/pi.md
  220. ```
  221. </details>
  222. <details>
  223. <summary><b>Gemini CLI</b></summary>
  224. ```bash
  225. mkdir -p ~/.gemini/skills/pi && cp skills/pi/SKILL.md ~/.gemini/skills/pi/SKILL.md
  226. ```
  227. </details>
  228. <details>
  229. <summary><b>GitHub Copilot CLI</b></summary>
  230. ```bash
  231. mkdir -p ~/.copilot/skills/pi && cp skills/pi/SKILL.md ~/.copilot/skills/pi/SKILL.md
  232. ```
  233. </details>
  234. <details>
  235. <summary><b>Qwen Code</b></summary>
  236. ```bash
  237. mkdir -p ~/.qwen/skills/pi && cp skills/pi/SKILL.md ~/.qwen/skills/pi/SKILL.md
  238. ```
  239. </details>
  240. <details>
  241. <summary><b>其他平台(Windsurf / Trae / Augment / COPAW / Iflow / Qoder)</b></summary>
  242. 通用模式:
  243. ```bash
  244. mkdir -p ~/.<platform>/skills/pi && cp skills/pi/SKILL.md ~/.<platform>/skills/pi/SKILL.md
  245. ```
  246. 替换 `<platform>` 为:`windsurf`、`trae`、`augment`、`copaw`、`iflow`、`qoder`
  247. </details>
  248. ### PI 决策可视化
  249. PI 自带本地决策历史可视化器(TypeScript + React + Vite),将 `~/.pi/decisions` 中的脱敏决策历史渲染为可交互页面。核心功能:
  250. - 🌳 **决策树可视化** — React Flow 驱动的交互式决策图,支持拖拽、缩放、平移
  251. - ⏱️ **时间线回放** — 滑动时间轴重现决策演进过程
  252. - 📤 **一键导出** — 导出/导入带隐私脱敏的决策存档,支持分享
  253. - 🔴 **实时预览** — WebSocket 实时监听决策变更,自动刷新
  254. 安装方式:一键安装(`install.sh`)会自动放置 `~/.pi/visualize.sh` 启动器。首次运行时自动 bootstrap 运行时环境(需要 `git` 和 `node`/`npm`)。
  255. 常用入口:
  256. ```bash
  257. ~/.pi/visualize.sh
  258. ```
  259. 如果你的宿主还接入了命令路由,也可以使用:
  260. ```text
  261. /pi visualize
  262. ```
  263. Cursor 用户除了 `pi.mdc` 外,也建议同时安装:
  264. ```bash
  265. mkdir -p .cursor/rules
  266. cp cursor/rules/pi-visualize.mdc .cursor/rules/pi-visualize.mdc
  267. ```
  268. 如果你只想单独安装 visualizer,也可以直接运行:
  269. ```bash
  270. curl -fsSL https://raw.githubusercontent.com/share-skills/pi/main/scripts/setup-standalone-visualize.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 363 on GitHub
  271. ```
  272. Standalone setup 依赖 `git` 和 `node`/`npm`。
  273. > 了解可视化背后的设计理念:[为什么 PI 有效](docs/WHY_PI_WORKS.md) · [设计哲学](docs/DESIGN_PHILOSOPHY.md) · [为什么需要编译器](docs/WHY_COMPILER.md) · [为什么要可视化](docs/WHY_VISUALIZE.md)
  274. ### 多语言支持
  275. 每个平台同时提供中文(`pi/`)和英文(`pi-en/`)两个版本。安装时选择你需要的语言:
  276. | 语言 | 中文目录 | 英文目录 |
  277. |------|---------|---------|
  278. | 中文 | `skills/pi/SKILL.md` | — |
  279. | English | — | `skills/pi-en/SKILL.md` |
  280. | 双语 | 两个都安装 | 两个都安装 |
  281. ### 渐进式披露
  282. 渐进式版本将完整 SKILL.md 拆为核心文件 + 4 个按需加载的参考文件,首次加载节省 ~43% token:
  283. | 文件 | 内容 | 加载时机 |
  284. |------|------|---------|
  285. | `SKILL.md` | 核心指令(强制令+决策表+智慧矩阵+方法体系+人机共振) | 启动时自动加载 |
  286. | `references/four-dojos.md` | 四大道场完整定义(编程·测试·产品·运营) | 对应场景激活 |
  287. | `references/battle-momentum.md` | 六阶战势+肃阵+天行+截教+十二灵兽 | 失败升级时 |
  288. | `references/resonance-forms.md` | 共振五式详细输出格式+示例 | 标准/深度模式 |
  289. | `references/team-protocol.md` | Agent Team 协作协议+决策三权+Coach巡检 | 多Agent场景 |
  290. 支持渐进式的平台:Claude Code · Copilot CLI · OpenClaw。Cursor/Kiro 不支持 references/,使用完整单文件版。
  291. ---
  292. ## Agent Team 用法
  293. PI 引擎原生支持多 Agent 团队协作:
  294. | 角色 | 认知阵 | 职责 |
  295. |------|---------|------|
  296. | **Leader** | ⚔️统帅+🏛️建筑师 | 全局调度、战阶管理 |
  297. | **Teammate** | 按任务分配 | 自强精进、L2+汇报 |
  298. | **Coach** | 🦊狐+🦅鹰 | 察觉懈怠、正向介入 |
  299. ### SubAgent 预加载 PI
  300. PI 提供预置 Agent 模板,通过 `skills: [pi]` 让 SubAgent 启动时自动加载 PI 方法论:
  301. ```bash
  302. # 安装 Teammate 模板(SubAgent 自动加载 PI)
  303. cp agents/pi-teammate.md ~/.claude/agents/pi-teammate.md
  304. # 安装 Coach(可选,伍人以上时推荐)
  305. cp agents/pi-coach.md ~/.claude/agents/pi-coach.md
  306. ```
  307. Leader 派遣 Teammate 时,指定 `agent: pi-teammate` 即可自动预加载 PI,无需手动加载。
  308. 你也可以在自定义 Agent 中预加载 PI:
  309. ```yaml
  310. # .claude/agents/my-agent.md
  311. ---
  312. name: my-agent
  313. description: "My custom agent"
  314. skills:
  315. - pi # 自动预加载 PI 方法论
  316. ---
  317. Your agent instructions here...
  318. ```
  319. ---
  320. ## 智慧根源
  321. PI 引擎融汇十六源智慧:
  322. | 类别 | 经典/源流 | 核心思想 |
  323. |------|---------|---------|
  324. | 古典九流 | 《孙子兵法》《鬼谷子》《道德经》《易经》《论语》《韩非子》《墨子》《公孙龙子》 阴阳五行 | 致人不致于人 · 捭阖之术 · 上善若水 · 天行健 · 智者不惑 · 法不阿贵 · 志不强者智不达 · 名实相副 · 一阴一阳 |
  325. | 修行破局 | 截教 · 禅宗 · 农家 | 截取一线生机 · 应无所住而生其心 · 仓廪实则知礼节 |
  326. | 西方方法论 | 斯多葛 · 实证主义 · 第一性原理 · 维特根斯坦 | 控制可控者 · 凡可验证者方为真知 · 从不可变事实出发 · 语言的意义在于用法 |
  327. ---
  328. ## 许可证
  329. [Apache-2.0](LICENSE) — 自由使用、修改、分享。
  330. ---
  331. > _🐲 智行合一,开创人机协同新纪元。_
  332. > _☯️ 大道五十,天衍四十九,截取一线生机。_
  333. > _⭐ 为世界贡献中国智慧。_
scripts/setup-standalone-visualize.sh · Bundled script · 128 lines · 1 finding marked
  1. #!/usr/bin/env bash
  2. #
  3. # Licensed to the Apache Software Foundation (ASF) under one or more
  4. # contributor license agreements. See the NOTICE file distributed with
  5. # this work for additional information regarding copyright ownership.
  6. # The ASF licenses this file to You under the Apache License, Version 2.0
  7. # (the "License"); you may not use this file except in compliance with
  8. # the License. You may obtain a copy of the License at
  9. #
  10. # http://www.apache.org/licenses/LICENSE-2.0
  11. #
  12. # Unless required by applicable law or agreed to in writing, software
  13. # distributed under the License is distributed on an "AS IS" BASIS,
  14. # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15. # See the License for the specific language governing permissions and
  16. # limitations under the License.
  17. #
  18. # Copyright (c) 2026 HePin
  19. #
  20. # Setup PI Standalone Visualizer
  21. #
  22. # Usage:
  23. # curl -fsSL https://raw.githubusercontent.com/share-skills/pi/main/scripts/setup-standalone-visualize.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 24 on GitHub
  24. # or
  25. # ./scripts/setup-standalone-visualize.sh
  26. set -euo pipefail
  27. PI_ROOT="${HOME}/.pi"
  28. INSTALL_DIR="${PI_ROOT}/visualize"
  29. SETUP_SCRIPT="${PI_ROOT}/setup-standalone-visualize.sh"
  30. REPO_URL="https://github.com/share-skills/pi.git"
  31. SCRIPT_URL="https://raw.githubusercontent.com/share-skills/pi/main/scripts/setup-standalone-visualize.sh"
  32. echo "🔮 Setting up PI Standalone Visualizer..."
  33. mkdir -p "$PI_ROOT"
  34. # Ensure Node.js/npm is installed
  35. if ! command -v node &> /dev/null || ! command -v npm &> /dev/null; then
  36. echo "❌ 'node' and 'npm' are required to build the visualizer." >&2
  37. echo "Install Node.js first: https://nodejs.org/" >&2
  38. exit 1
  39. fi
  40. if ! command -v git &> /dev/null; then
  41. echo "❌ 'git' is required to bootstrap or update the standalone visualizer runtime." >&2
  42. exit 1
  43. fi
  44. # Clone/Update visualize directory
  45. if [ -d "$INSTALL_DIR/.git" ]; then
  46. echo "Updating existing installation at $INSTALL_DIR..."
  47. cd "$INSTALL_DIR"
  48. git pull
  49. elif [ -d "$INSTALL_DIR" ]; then
  50. echo "Replacing non-git directory at $INSTALL_DIR with a fresh clone..."
  51. rm -rf "$INSTALL_DIR"
  52. git clone "$REPO_URL" "$INSTALL_DIR"
  53. else
  54. echo "Cloning full PI repository into $INSTALL_DIR..."
  55. echo "(Note: We use the visualize/ subdirectory, but clone the repo to support updates)"
  56. git clone "$REPO_URL" "$INSTALL_DIR"
  57. fi
  58. cd "$INSTALL_DIR/visualize"
  59. npm install
  60. npm run build
  61. # Keep a local copy so future runs can re-bootstrap even after `curl | bash`.
  62. CLONED_SETUP_SCRIPT="$INSTALL_DIR/scripts/setup-standalone-visualize.sh"
  63. if [[ -r "$CLONED_SETUP_SCRIPT" && "$CLONED_SETUP_SCRIPT" != "$SETUP_SCRIPT" ]]; then
  64. cp "$CLONED_SETUP_SCRIPT" "$SETUP_SCRIPT"
  65. elif [[ -n "${BASH_SOURCE[0]:-}" && -r "${BASH_SOURCE[0]}" ]]; then
  66. SOURCE_SCRIPT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/$(basename "${BASH_SOURCE[0]}")"
  67. if [[ "$SOURCE_SCRIPT" != "$SETUP_SCRIPT" ]]; then
  68. cp "$SOURCE_SCRIPT" "$SETUP_SCRIPT"
  69. fi
  70. elif command -v curl >/dev/null 2>&1; then
  71. curl -fsSL "$SCRIPT_URL" -o "$SETUP_SCRIPT"
  72. else
  73. echo "❌ Unable to persist $SETUP_SCRIPT because this run has no readable source file and 'curl' is unavailable." >&2
  74. exit 1
  75. fi
  76. chmod +x "$SETUP_SCRIPT"
  77. # Create wrapper script
  78. WRAPPER_SCRIPT="${PI_ROOT}/visualize.sh"
  79. cat <<EOF > "$WRAPPER_SCRIPT"
  80. #!/usr/bin/env bash
  81. set -euo pipefail
  82. PI_ROOT="\${HOME}/.pi"
  83. INSTALL_DIR="\${PI_ROOT}/visualize"
  84. SETUP_SCRIPT="\${PI_ROOT}/setup-standalone-visualize.sh"
  85. CLONED_SETUP_SCRIPT="\${INSTALL_DIR}/scripts/setup-standalone-visualize.sh"
  86. if [[ ! -f "\${INSTALL_DIR}/visualize/package.json" ]]; then
  87. echo "PI visualizer runtime is not installed yet."
  88. echo "Bootstrapping standalone visualizer into \${INSTALL_DIR}..."
  89. if [[ ! -x "\$SETUP_SCRIPT" ]]; then
  90. if [[ -r "\$CLONED_SETUP_SCRIPT" ]]; then
  91. echo "Restoring setup script from \${CLONED_SETUP_SCRIPT}..."
  92. cp "\$CLONED_SETUP_SCRIPT" "\$SETUP_SCRIPT"
  93. chmod +x "\$SETUP_SCRIPT"
  94. elif command -v curl >/dev/null 2>&1; then
  95. echo "Refreshing missing setup script into \$SETUP_SCRIPT..."
  96. curl -fsSL "$SCRIPT_URL" -o "\$SETUP_SCRIPT"
  97. chmod +x "\$SETUP_SCRIPT"
  98. else
  99. echo "Missing setup script: \$SETUP_SCRIPT" >&2
  100. exit 1
  101. fi
  102. fi
  103. bash "\$SETUP_SCRIPT"
  104. fi
  105. cd "\${INSTALL_DIR}/visualize"
  106. if [[ ! -d "node_modules" ]]; then
  107. npm install
  108. fi
  109. exec npm run server -- "\$@"
  110. EOF
  111. chmod +x "$WRAPPER_SCRIPT"
  112. echo "✅ PI Visualizer setup complete!"
  113. echo "Run it with: $WRAPPER_SCRIPT"

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.