@aliou/pi-toolchain
强制使用指定工具链，拦截或替换不匹配命令
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@aliou/pi-toolchain。 它的用途是：强制使用指定工具链，拦截或替换不匹配命令 完整的 Skill 内容见：https://321skill.com/skills/aliou-pi-toolchain/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'安装项目依赖'，如果你习惯输入 npm install，但团队统一使用 pnpm，该 skill 会自动将命令替换为 pnpm install 并执行。或者配置 block 模式后，输入 npm install 会被拒绝，AI 会提示你使用 pnpm install，然后自动重试正确的命令，从而避免依赖锁文件不一致的问题。
介绍
这个 Skill 解决了在 AI Agent 终端中随意使用不同包管理器、Python 版本或 Git 命令导致的环境不一致问题。实际开发中，团队成员可能混用 npm、yarn、pnpm、bun，或者直接输入 python 而非 python3，或者忘记给 git rebase 注入非交互环境变量，造成构建失败、脚本卡死等连锁问题。
使用方式很简单，你只需要通过 pi install npm:@aliou/pi-toolchain 安装，然后运行 /toolchain:settings 打开交互配置界面，在 Local 或 Global 标签页中开启对应功能（如 nodePackageManager 设为 mutate 或 block）。之后当你输入 npm install 时，AI 会自动将其替换为 pnpm install；若设为 block 模式，则会直接提示“请使用 pnpm”并拒绝执行。
它非常适合需要统一团队开发环境、规范终端命令使用的团队或个人。尤其是那些已经在使用 pi 作为 AI Agent 平台、且多名开发者协作的项目，可以避免因个人习惯差异导致的意外错误。对于 Python 项目，它还能自动将 python 转为 python3 或 uv run python，并同步处理 pip 命令。
建议在团队初始化项目时统一配置此工具，并采用 mutate 模式以最小化对开发体验的干扰。需要注意的是，它仅适用于 pi 环境，普通终端不受影响；nonInteractiveGitRebase 功能默认开启，若需要交互式 rebase 请手动将其设为 disabled。
常见问题
如何启用 pnpm 强制替换？
运行 /toolchain:settings，在 Local 或 Global 标签页中将 nodePackageManager 设为 mutate，并将 selected 改为 pnpm。保存后，所有 npm/yarn/bun 命令都会自动替换为 pnpm。
mutate 和 block 模式有什么区别？
mutate 模式会透明替换命令，AI 看到的是原命令但实际执行的是替换后的命令；block 模式会直接拒绝执行并返回错误信息，AI 会重试正确的命令。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/aliou-pi-toolchain/raw/index.md 读取 @aliou/pi-toolchain 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/aliou-pi-toolchain/raw/index.md（查看排版版本）