SuperAPI AI 工具集

pi-agent-rust

编程与开发

查看项目

更新于 10-15 21:39

技能介绍

用途:该技能用于加速 pi_agent_rust 的开发与验证工作流,适用于编辑 providers、tools、sessions、extensions、installer/uninstaller 逻辑等场景。

主要能力:提供 60 秒引导命令、症状路由(Symptom Router)表、非协商规则(Non-Negotiables)、核心工作流、变更文件到必需测试的对照表、高价值命令、关键文件清单、已知陷阱(Known Footguns)、补丁模式与失败排查指引。

使用方式:先设置环境变量并执行引导命令:export CARGO_TARGET_DIR="/data/tmp/pi_agent_rust/${USER:-agent}";export TMPDIR="/data/tmp/pi_agent_rust/${USER:-agent}/tmp";mkdir -p "$TMPDIR";随后运行 rch exec -- cargo check --all-targets、rch exec -- cargo clippy --all-targets -- -D warnings、cargo fmt --check、bash tests/installer_regression.sh。按症状路由选择对应测试,例如 provider 流式/工具调用回归用 cargo test provider_streaming -- --nocapture,会话回放/索引漂移用 cargo test session -- --nocapture,扩展策略/运行时失败用 cargo test extension -- --nocapture,安装/卸载/技能问题用 bash tests/installer_regression.sh,交互与 RPC 分歧用 cargo test e2e_rpc -- --nocapture。

限制与规则:先读 AGENTS.md 并严格遵循;不得删除文件或运行破坏性 git/文件系统命令;保持就地编辑,避免为同一目的创建变体文件;文档/脚本使用 main 语义,不引入 master;优先用 rg 做文本侦察、ast-grep 做结构化匹配/重构;重编译/测试负载优先用 rch exec -- <cargo ...>;实质性编辑后运行编译/检查/格式门禁及最小相关回归切片。安装/技能变更需通过 tests/installer_regression.sh 与 scripts/skill-smoke.sh。更深入诊断见 references/DEBUGGING-PLAYBOOKS.md,扩展命令见 references/COMMANDS.md。