按平台选择兼容命令
Cross-Platform Handling
确认操作系统和目标支持情况后，再选择对应命令。
工具调用
用路由表选择工具
Tool Routing Tables
把每类操作对应到支持它的工具，并说明允许的替代方式。
检查已安装版本与可用版本
Version Check
比较版本差异，同时避免阻断与升级无关的任务。
在独立检出目录中评审
Isolated Review Checkout
把评审放到独立的代码目录，避免影响正在实现的工作。
错开批量查询并限制速率
Staggered Burst Query + Rate Limits
分批错开请求时间，并遵守服务的速率限制。
先了解现状，再采取行动
Reconnaissance-Then-Action
在修改前先读取相关代码和环境信息，确认实际情况。
按接口使用辅助脚本
Helper Script as Black Box
先查看脚本支持的参数，能按接口完成任务时无需阅读整个实现。
Composio 三步接入 SaaS
Composio 3-Step SaaS Integration
先查询可用操作，再检查连接，最后执行参数已校验的调用。
识别可以安全并行的步骤
Parallel-Safe Step Identification
独立读取可以并行；修改和依赖后续结果的检查按顺序执行。
用 Hook 自动执行生命周期动作
Hook-Driven Automation
响应已配置的事件钩子，并保留有意设置的阻止条件。
在 REPL 中组合工具调用
REPL as Tool Composition
在编程层明确连接工具的输入和输出，组合已知的调用。
设计方便 Agent 使用的工具接口
Agent-Centric Tool Design Principles
接口说明意图，结果提供有用证据，错误告诉调用方如何继续。
锁定不同来源的安装版本
Marketplace Source-Type Polymorphism (SHA-Pinned)
处理不同插件来源时，用固定 SHA 保证安装的是指定版本。
缺少能力时说明限制
Capability-Absent Anti-Fabrication Fallback
工具不能完成某项操作时，说明缺口并提供可行的替代步骤。
实际试用能力，而不只检查存在
Capability Smoke-Test Over Presence-Check
运行一个小任务，确认工具能工作，而不只确认已经安装。
保留固定网址，改名时添加跳转
Immutable-Slug Identity with Rename Redirect Map
用稳定的 slug 标识条目，改名后让旧网址跳转到新位置。
按错误类型选择恢复方式
Recover according to failure class
分别处理权限不足、参数错误、限流和空数据，避免一律重试。
更新前读取当前版本号
Read fresh version tokens before update
用资源最新的并发版本令牌执行写入，避免覆盖别人刚做的修改。
先查询当前可用的能力
Choose capabilities from current metadata
选择模型或声音前，先确认服务当前支持的标识符和功能。
确认分页数据已全部读取
Prove paginated retrieval is complete
按接口规则读取后续页，明确区分完整结果和只取到部分数据。
批量请求成功后仍检查每一项
Validate per-item outcomes inside batch success
外层请求成功不代表每项都成功，需要检查内部逐项结果。
编辑前确认是替换还是局部更新
Check replace semantics before editing
根据接口的更新语义选择操作，避免局部修改变成全文覆盖。
在正确范围内查询资源 ID
Resolve opaque IDs within their scope
将名称转换成服务 ID 时保留所属组织或父资源的范围。
构造参数前读取 schema 引用
Resolve schema references before arguments
先展开引用的数据结构，确认真实字段和约束，再调用工具。
先确定要回答的问题，再设置监控
Question-to-signal observability
根据操作人员需要判断什么，选择要记录的指标和信号。
为流式任务设置总时限
Use a deadline independent of stream activity
除无活动超时外，还设置总截止时间，避免心跳让任务无限占用资源。
简化 schema 时保留完整业务校验
Retain full validation beside a compatible schema
宿主只接受部分 schema 特性时，仍要在其他位置执行完整校验。
工具交接时保留坐标单位
Preserve coordinate units through tool handoffs
位置数据同时传递单位、尺寸和原点；混用不同坐标来源时先转换。
断线重连时补齐遗漏事件
Reconnect event streams without gaps
结合实时流和历史记录恢复事件，按事件 ID 去重，并独立检查停止条件。
完整校验流式响应后再执行工具
Validate the whole streamed turn before acting
等生成结束、参数解析和工具校验都通过，再执行客户端工具。
把需要管控的动作定义成明确工具
Promote opaque actions to typed control points
需要单独授权、显示、审计或调度的动作，应提供有类型约束的工具接口。
等待明确的就绪条件
Wait on a fresh observable predicate
用刚读取的可观察条件判断是否就绪，并设置超时，避免猜测等待时间。
按依赖类型选择验证替代方案
Dependency-calibrated verification adapters
根据模块控制的是哪种依赖，选择合适的模拟或替代检查。
区分工具目录和项目目录
Keep tool roots separate from project roots
工具代码从 Skill 安装目录查找，项目文件从声明的工作目录解析。
入队前一次性预留预算
Atomic Budget Admission Before Enqueue
接收高成本任务前，原子地预留允许使用的预算。
先用确定性解析，再处理疑难项
Deterministic Parse with Uncertain-Case Escalation
先运行普通解析器，仅把结构不确定的记录交给模型判断。
用独立参考点验证坐标校准
Identifiable Calibration with a Holdout
用足够的独立锚点求出坐标变换，再用另一组参考点验证。
检查完整动作顺序和最终状态
Ordered Actions and Final-State Audit
追踪全部动作，特别是后续操作是否撤销了前面的结果。
让证据对应同一份稳定内容
Evidence Bound to the Same Stable Bytes
证据包中的大小、摘要和测量都应描述同一版本的源文件。
同时确认进程退出和任务完成
Process Success and Semantic Completion Handshake
后台进程退出成功后，还需找到任务完成记录，才能报告完成。
结合结构化状态和页面证据
Structured State and Rendered Evidence
任何一类证据单独不足时，同时检查应用状态和实际渲染结果。
写入前校验拟修改的内容
Validate the Proposed Mutation
批准操作前先检查它将写入什么，避免只根据操作名称判断。
隔离可选能力的加载失败
Isolate Optional Capability Loading Failures
在能力边界内加载可选组件；失败时明确说明，并避免影响其他功能。