用途:在 pi_agent_rust 仓库内进行安全、可验证的快速修改,尤其涉及 provider、工具、会话、扩展行为,以及安装器/卸载器/技能安装逻辑时,提供定向排查与确定性安全检查。
主要能力:提供 60 秒引导命令、症状路由表(按 provider 流式/工具调用、会话重放/索引漂移、扩展策略/运行时、安装卸载、交互与 RPC 分歧给出首批命令)、必守规则、核心工作流、变更文件到必需测试的映射、高价值命令、关键文件说明、已知陷阱与补丁模式。
使用方式:先读 AGENTS.md 并遵循;设置 CARGO_TARGET_DIR 与 TMPDIR 后执行 rch exec -- cargo check --all-targets、rch exec -- cargo clippy --all-targets -- -D warnings、cargo fmt --check、bash tests/installer_regression.sh。按症状路由选择测试,如 cargo test --test provider_streaming -- --nocapture、cargo test session、cargo test extension、cargo test --test e2e_rpc、cargo test conformance。安装相关改动需运行 bash -n、shellcheck -x、bash tests/installer_regression.sh、bash scripts/skill-smoke.sh。
适用场景:编辑 provider/tool/session/extension、安装卸载与技能安装逻辑,或需要症状优先的调试手册而非临时找命令时。
限制:不得删除文件或运行破坏性 git/文件系统命令;保持就地编辑,避免创建同用途变体文件;文档与脚本使用 main 语义;优先 rg 与 ast-grep;重编译/测试优先 rch exec;实质性修改后需通过编译/检查/格式门禁与最小相关回归。未提供收费、平台与效果信息。