Back to search
pi
SkillGitHub
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
Markdown
[](/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)
- {
- "name": "pi-skills",
- "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",
- "owner": {
- "name": "pi-team",
- "url": "https://github.com/share-skills/pi"
- },
- "plugins": [
- {
- "name": "pi",
- "description": "PI (Wisdom-in-Action) Engine v10 — zero-question imperatives, ⚡PI-01~05 KV-Cache anchors, scene router, delivery quality gates, four dojos",
- "version": "10.0.0",
- "source": "./",
- "author": {
- "name": "pi-team",
- "url": "https://github.com/share-skills/pi"
- }
- }
- ]
- }
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)
- # PI — 智行合一引擎 v23.2.0
- <p>
- <img src="https://img.shields.io/badge/version-23.2.0-blue?style=flat-square" alt="Version">
- <img src="https://img.shields.io/badge/license-Apache_2.0-green?style=flat-square" alt="License">
- <img src="https://img.shields.io/badge/lang-中文_|_English-orange?style=flat-square" alt="Language">
- </p>
- <p>
- <img src="https://img.shields.io/badge/Claude_Code-black?style=flat-square&logo=anthropic&logoColor=white" alt="Claude Code">
- <img src="https://img.shields.io/badge/OpenAI_Codex_CLI-412991?style=flat-square&logo=openai&logoColor=white" alt="OpenAI Codex CLI">
- <img src="https://img.shields.io/badge/Cursor-000?style=flat-square&logo=cursor&logoColor=white" alt="Cursor">
- <img src="https://img.shields.io/badge/Kiro-232F3E?style=flat-square&logo=amazon&logoColor=white" alt="Kiro">
- <img src="https://img.shields.io/badge/Gemini_CLI-4285F4?style=flat-square&logo=google&logoColor=white" alt="Gemini CLI">
- <img src="https://img.shields.io/badge/Copilot_CLI-000?style=flat-square&logo=github&logoColor=white" alt="Copilot CLI">
- <img src="https://img.shields.io/badge/Qwen_Code-FF6A00?style=flat-square&logo=alibaba-cloud&logoColor=white" alt="Qwen Code">
- <img src="https://img.shields.io/badge/Windsurf-06B6D4?style=flat-square" alt="Windsurf">
- <img src="https://img.shields.io/badge/Trae-FF4500?style=flat-square" alt="Trae">
- <img src="https://img.shields.io/badge/Augment-8B5CF6?style=flat-square" alt="Augment">
- <img src="https://img.shields.io/badge/COPAW-2D3748?style=flat-square" alt="COPAW">
- <img src="https://img.shields.io/badge/Iflow-00D4AA?style=flat-square" alt="Iflow">
- <img src="https://img.shields.io/badge/Qoder-333?style=flat-square" alt="Qoder">
- </p>
- [English](README.en.md) | **中文**
- 阿里内网用户欢迎加群交流 【群号: 156800004200 / TMCP 天使用户群】
- 
- 
- > **智者不惑,仁者不忧,勇者不惧。** ——《论语·子罕》
- **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](SKILL.md)。
- ### 🔗 场景链·组合拳
- | 场景链 | 典型任务 |
- |--------|---------|
- | 🖥️→🧪 | 写完代码 → 自动设计测试 |
- | 📊→🖥️→🧪 | 需求分析 → 开发 → 测试 |
- | 🔧→🖥️→🧪 | Bug修复全链贯通 |
- | 📈→📊→🖥️ | 数据驱动的产品改进 |
- ### 🏁 交付质量门(v7 新增)
- | 道场 | 质量标准 | 验证方式 |
- |------|---------|---------|
- | 🖥️ 编程 | 编译通过 + 测试绿 + 审码五维无红线 | build/test 输出 |
- | 🧪 测试 | 覆盖边界 + 独立可重复 + 失败定位精准 | 测试报告 |
- | 📊 产品 | 痛点可量化 + 方案最简 + 指标可度量 | 数据/用户反馈 |
- | 📈 运营 | 实验可度量 + 成功标准明确 + 反馈回路 | 实验卡片 |
- ### 🖥️ 四道合一
- 四大专业道场,每道均有"四令+三则"认知结构:
- #### 编程道场
- | 模块 | 内容 |
- |------|------|
- | **编程四令** | 本质→约束→命名→验证 |
- | **正名三则** | 概念不清不建模 · 一词一义 · 争论先校准 |
- | **调试六步** | 读败→定界→溯源→比对→验假→固防 |
- | **审码五维** | 安全 · 性能 · 可读 · 正确 · 健壮 |
- | **重构之道** | 三信号 + 三原则 |
- | **架构决策树** | 第一性原理驱动选型 |
- #### 测试道场 · 产品道场 · 运营道场
- 每道均有:四令(核心认知关卡)+ 三则(行动准则)+ 专属认知流
- ### 🐾 十二灵兽图腾
- | 灵兽 | 精神 | 困境 | 行为指令 |
- |------|------|------|---------|
- | 🦅 鹰 | 洞察 | 陷入细节 | 俯瞰全局,找关键路径 |
- | 🐺🐯 狼虎 | 直言/破伪 | 假设未验证 / 风险已知而未言 | 深入事实,消除偏差;风险不说破,等于共谋 |
- | 🦁 狮 | 奋战 | 即将放弃 | 决战时刻,聚力破局 |
- | 🐎 马 | 竞速 | 效率低下 | 即验即交,附输出 |
- | 🐂 牛 | 坚韧 | 任务艰难 | 迎难不避,坚韧以行 |
- | 🦈 鲨 | 搜索/潜搜 | 没搜就猜 / 深层隐患被回避 | 搜乃决断之粮;潜入水底,探测暗流 |
- | 🐝 蜂 | 突击 | 终极冲刺 | 全原型协同出击 |
- | 🦊 狐 | 审慎 | 质量偏低 | 审视产出,确保质量 |
- | 🐲 龙 | 极限 | 极限突破 | 全力穷尽 |
- | 🦄 独角兽 | 卓越 | 敷衍了事 | 精益求精,止于至善 |
- | 🦉 猫头鹰 | 洞明 | 结论草率 | 缓虑静思,逐步推理 |
- | 🐬 海豚 | 灵变 | 思路僵化 | 触类旁通,跨域求解 |
- > 🐲 **龙**指中华龙(Loong),中华文明瑞兽图腾,象征力量、智慧与变化。
- >
- > 🐺🐯 **狼虎**一体两面:🐺狼面攻认知盲区(不知而言),🐯虎面攻态度缺陷(知而不言)。单 Agent 两面同时激活;多 Agent 拆为对向验证。
- >
- > 🦈 **鲨**一体两面:广度鲨横扫全域(未搜而断),深度鲨纵潜暗流(浅搜而避)。单 Agent 广度深度同时激活;多 Agent 拆为对向验证。
- ### ⚡ 六阶战势
- 失败2次起触发,逐阶升级:
- | 失败 | 阶名 | 核心行动 | 经典 |
- |------|------|---------|------|
- | 2次 | ⚡易辙 | 换道破局 | 避实击虚 |
- | 3次 | 🦈深搜 | 穷搜广读+三策验之 | 知彼知己 |
- | 4次 | 🐲系统 | 九令洞鉴+3新假设 | 庙算多胜 |
- | 5次 | 🦁决死 | 最小实证+隔离+另辟蹊径 | 置之死地 |
- | 6次 | ☯️截道 | 非标路径+跨域类比+逆向思维 | 截取一线生机 |
- | 7次+ | 🐝天行 | 全原型协同出击 | 天行健 |
- ### 🔍 共振五式(思维透明化)
- > 以铜为镜,可以正衣冠;以人为镜,可以明得失。
- 使 AI 思维对人**可见·可追问·可干预**,与难度三档联动:
- | 式 | 名 | 要义 | 触发 |
- |---|-----|------|------|
- | 一 | 💭 **明链** | 思维链三档显式输出(🏊🏻1句/🏋️四步/🐲九令) | 标准/深度强制,轻量按需 |
- | 二 | 🎯 **明证** | 结论必附假设+证据+已排除项 | 建议性输出 · 战势二阶+ |
- | 三 | 🌳 **明树** | 问题拆解可视化,人选介入点 | 子问题>3 · 战势四阶+ |
- | 四 | 🧠 **明心** | 信心·资源状态汇报,联动止损三阶 | 每三次交互 · 模式切换 |
- | 五 | 📋 **明约** | 交付前人机双确认清单 | 标准/深度模式交付前 |
- ---
- ## 快速安装
- ### 一键安装(推荐)
- ```bash
- 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
- ```
- 交互式安装,自动检测已安装平台,支持选择语言。
- 安装器还会放置 `~/.pi/visualize.sh` 可视化启动器;首次运行 `~/.pi/visualize.sh` 时,会按需引导安装本地可视化运行时(需要 `git` 和 `node`/`npm`)。如果你的宿主额外接入了 `commands/` 路由,再使用 `/pi visualize` 这类快捷入口。
- ### 手动安装
- <details>
- <summary><b>Claude Code(推荐方式)</b></summary>
- **方式一:Marketplace 安装**
- ```bash
- claude install-plugin https://github.com/share-skills/pi
- ```
- **方式二:手动安装**
- ```bash
- 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/
- ```
- </details>
- <details>
- <summary><b>OpenAI Codex CLI</b></summary>
- ```bash
- mkdir -p ~/.codex/skills/pi && cp skills/pi/SKILL.md ~/.codex/skills/pi/SKILL.md
- ```
- </details>
- <details>
- <summary><b>Cursor</b></summary>
- ```bash
- mkdir -p .cursor/rules
- cp cursor/rules/pi.mdc .cursor/rules/pi.mdc
- cp cursor/rules/pi-visualize.mdc .cursor/rules/pi-visualize.mdc
- ```
- </details>
- <details>
- <summary><b>Kiro</b></summary>
- ```bash
- mkdir -p .kiro/steering && cp kiro/steering/pi.md .kiro/steering/pi.md
- ```
- </details>
- <details>
- <summary><b>Gemini CLI</b></summary>
- ```bash
- mkdir -p ~/.gemini/skills/pi && cp skills/pi/SKILL.md ~/.gemini/skills/pi/SKILL.md
- ```
- </details>
- <details>
- <summary><b>GitHub Copilot CLI</b></summary>
- ```bash
- mkdir -p ~/.copilot/skills/pi && cp skills/pi/SKILL.md ~/.copilot/skills/pi/SKILL.md
- ```
- </details>
- <details>
- <summary><b>Qwen Code</b></summary>
- ```bash
- mkdir -p ~/.qwen/skills/pi && cp skills/pi/SKILL.md ~/.qwen/skills/pi/SKILL.md
- ```
- </details>
- <details>
- <summary><b>其他平台(Windsurf / Trae / Augment / COPAW / Iflow / Qoder)</b></summary>
- 通用模式:
- ```bash
- mkdir -p ~/.<platform>/skills/pi && cp skills/pi/SKILL.md ~/.<platform>/skills/pi/SKILL.md
- ```
- 替换 `<platform>` 为:`windsurf`、`trae`、`augment`、`copaw`、`iflow`、`qoder`
- </details>
- ### PI 决策可视化
- PI 自带本地决策历史可视化器(TypeScript + React + Vite),将 `~/.pi/decisions` 中的脱敏决策历史渲染为可交互页面。核心功能:
- - 🌳 **决策树可视化** — React Flow 驱动的交互式决策图,支持拖拽、缩放、平移
- - ⏱️ **时间线回放** — 滑动时间轴重现决策演进过程
- - 📤 **一键导出** — 导出/导入带隐私脱敏的决策存档,支持分享
- - 🔴 **实时预览** — WebSocket 实时监听决策变更,自动刷新
- 安装方式:一键安装(`install.sh`)会自动放置 `~/.pi/visualize.sh` 启动器。首次运行时自动 bootstrap 运行时环境(需要 `git` 和 `node`/`npm`)。
- 常用入口:
- ```bash
- ~/.pi/visualize.sh
- ```
- 如果你的宿主还接入了命令路由,也可以使用:
- ```text
- /pi visualize
- ```
- Cursor 用户除了 `pi.mdc` 外,也建议同时安装:
- ```bash
- mkdir -p .cursor/rules
- cp cursor/rules/pi-visualize.mdc .cursor/rules/pi-visualize.mdc
- ```
- 如果你只想单独安装 visualizer,也可以直接运行:
- ```bash
- 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
- ```
- Standalone setup 依赖 `git` 和 `node`/`npm`。
- > 了解可视化背后的设计理念:[为什么 PI 有效](docs/WHY_PI_WORKS.md) · [设计哲学](docs/DESIGN_PHILOSOPHY.md) · [为什么需要编译器](docs/WHY_COMPILER.md) · [为什么要可视化](docs/WHY_VISUALIZE.md)
- ### 多语言支持
- 每个平台同时提供中文(`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 方法论:
- ```bash
- # 安装 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:
- ```yaml
- # .claude/agents/my-agent.md
- ---
- name: my-agent
- description: "My custom agent"
- skills:
- - pi # 自动预加载 PI 方法论
- ---
- Your agent instructions here...
- ```
- ---
- ## 智慧根源
- PI 引擎融汇十六源智慧:
- | 类别 | 经典/源流 | 核心思想 |
- |------|---------|---------|
- | 古典九流 | 《孙子兵法》《鬼谷子》《道德经》《易经》《论语》《韩非子》《墨子》《公孙龙子》 阴阳五行 | 致人不致于人 · 捭阖之术 · 上善若水 · 天行健 · 智者不惑 · 法不阿贵 · 志不强者智不达 · 名实相副 · 一阴一阳 |
- | 修行破局 | 截教 · 禅宗 · 农家 | 截取一线生机 · 应无所住而生其心 · 仓廪实则知礼节 |
- | 西方方法论 | 斯多葛 · 实证主义 · 第一性原理 · 维特根斯坦 | 控制可控者 · 凡可验证者方为真知 · 从不可变事实出发 · 语言的意义在于用法 |
- ---
- ## 许可证
- [Apache-2.0](LICENSE) — 自由使用、修改、分享。
- ---
- > _🐲 智行合一,开创人机协同新纪元。_
- > _☯️ 大道五十,天衍四十九,截取一线生机。_
- > _⭐ 为世界贡献中国智慧。_
scripts/setup-standalone-visualize.sh · Bundled script · 128 lines · 1 finding marked
- #!/usr/bin/env bash
- #
- # Licensed to the Apache Software Foundation (ASF) under one or more
- # contributor license agreements. See the NOTICE file distributed with
- # this work for additional information regarding copyright ownership.
- # The ASF licenses this file to You under the Apache License, Version 2.0
- # (the "License"); you may not use this file except in compliance with
- # the License. You may obtain a copy of the License at
- #
- # http://www.apache.org/licenses/LICENSE-2.0
- #
- # Unless required by applicable law or agreed to in writing, software
- # distributed under the License is distributed on an "AS IS" BASIS,
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- # See the License for the specific language governing permissions and
- # limitations under the License.
- #
- # Copyright (c) 2026 HePin
- #
- # Setup PI Standalone Visualizer
- #
- # Usage:
- # 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
- # or
- # ./scripts/setup-standalone-visualize.sh
- set -euo pipefail
- PI_ROOT="${HOME}/.pi"
- INSTALL_DIR="${PI_ROOT}/visualize"
- SETUP_SCRIPT="${PI_ROOT}/setup-standalone-visualize.sh"
- REPO_URL="https://github.com/share-skills/pi.git"
- SCRIPT_URL="https://raw.githubusercontent.com/share-skills/pi/main/scripts/setup-standalone-visualize.sh"
- echo "🔮 Setting up PI Standalone Visualizer..."
- mkdir -p "$PI_ROOT"
- # Ensure Node.js/npm is installed
- if ! command -v node &> /dev/null || ! command -v npm &> /dev/null; then
- echo "❌ 'node' and 'npm' are required to build the visualizer." >&2
- echo "Install Node.js first: https://nodejs.org/" >&2
- exit 1
- fi
- if ! command -v git &> /dev/null; then
- echo "❌ 'git' is required to bootstrap or update the standalone visualizer runtime." >&2
- exit 1
- fi
- # Clone/Update visualize directory
- if [ -d "$INSTALL_DIR/.git" ]; then
- echo "Updating existing installation at $INSTALL_DIR..."
- cd "$INSTALL_DIR"
- git pull
- elif [ -d "$INSTALL_DIR" ]; then
- echo "Replacing non-git directory at $INSTALL_DIR with a fresh clone..."
- rm -rf "$INSTALL_DIR"
- git clone "$REPO_URL" "$INSTALL_DIR"
- else
- echo "Cloning full PI repository into $INSTALL_DIR..."
- echo "(Note: We use the visualize/ subdirectory, but clone the repo to support updates)"
- git clone "$REPO_URL" "$INSTALL_DIR"
- fi
- cd "$INSTALL_DIR/visualize"
- npm install
- npm run build
- # Keep a local copy so future runs can re-bootstrap even after `curl | bash`.
- CLONED_SETUP_SCRIPT="$INSTALL_DIR/scripts/setup-standalone-visualize.sh"
- if [[ -r "$CLONED_SETUP_SCRIPT" && "$CLONED_SETUP_SCRIPT" != "$SETUP_SCRIPT" ]]; then
- cp "$CLONED_SETUP_SCRIPT" "$SETUP_SCRIPT"
- elif [[ -n "${BASH_SOURCE[0]:-}" && -r "${BASH_SOURCE[0]}" ]]; then
- SOURCE_SCRIPT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/$(basename "${BASH_SOURCE[0]}")"
- if [[ "$SOURCE_SCRIPT" != "$SETUP_SCRIPT" ]]; then
- cp "$SOURCE_SCRIPT" "$SETUP_SCRIPT"
- fi
- elif command -v curl >/dev/null 2>&1; then
- curl -fsSL "$SCRIPT_URL" -o "$SETUP_SCRIPT"
- else
- echo "❌ Unable to persist $SETUP_SCRIPT because this run has no readable source file and 'curl' is unavailable." >&2
- exit 1
- fi
- chmod +x "$SETUP_SCRIPT"
- # Create wrapper script
- WRAPPER_SCRIPT="${PI_ROOT}/visualize.sh"
- cat <<EOF > "$WRAPPER_SCRIPT"
- #!/usr/bin/env bash
- set -euo pipefail
- PI_ROOT="\${HOME}/.pi"
- INSTALL_DIR="\${PI_ROOT}/visualize"
- SETUP_SCRIPT="\${PI_ROOT}/setup-standalone-visualize.sh"
- CLONED_SETUP_SCRIPT="\${INSTALL_DIR}/scripts/setup-standalone-visualize.sh"
- if [[ ! -f "\${INSTALL_DIR}/visualize/package.json" ]]; then
- echo "PI visualizer runtime is not installed yet."
- echo "Bootstrapping standalone visualizer into \${INSTALL_DIR}..."
- if [[ ! -x "\$SETUP_SCRIPT" ]]; then
- if [[ -r "\$CLONED_SETUP_SCRIPT" ]]; then
- echo "Restoring setup script from \${CLONED_SETUP_SCRIPT}..."
- cp "\$CLONED_SETUP_SCRIPT" "\$SETUP_SCRIPT"
- chmod +x "\$SETUP_SCRIPT"
- elif command -v curl >/dev/null 2>&1; then
- echo "Refreshing missing setup script into \$SETUP_SCRIPT..."
- curl -fsSL "$SCRIPT_URL" -o "\$SETUP_SCRIPT"
- chmod +x "\$SETUP_SCRIPT"
- else
- echo "Missing setup script: \$SETUP_SCRIPT" >&2
- exit 1
- fi
- fi
- bash "\$SETUP_SCRIPT"
- fi
- cd "\${INSTALL_DIR}/visualize"
- if [[ ! -d "node_modules" ]]; then
- npm install
- fi
- exec npm run server -- "\$@"
- EOF
- chmod +x "$WRAPPER_SCRIPT"
- echo "✅ PI Visualizer setup complete!"
- echo "Run it with: $WRAPPER_SCRIPT"
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.