提高云端任务可验证性

Cloud Agent 能否验证修改，往往取决于仓库能否在新环境复现开发流程。先让测试和依赖可用，再扩大任务范围。

核对环境与访问

通过环境配置准备运行时、依赖和启动方式。需要的 API key、数据库凭据在 Dashboard Secrets 配置；云角色优先使用支持的 OIDC 短期身份，避免长期密钥。开启网络限制时，把本地开发必需的真实目标纳入允许范围。

测试不应依赖虚拟机无法访问的隐藏本地服务。把必须启动的服务、测试账号和失败诊断路径写清楚，让 Agent 能区分产品错误与环境未准备好。

把知识放在适当位置

仓库说明用于解释最常见的启动、测试和调试入口；Skills 保存细节较多且可复用的任务方法。仓库 Skill 随代码提交，个人 Skill 可同步给自己的 Cloud Agents，团队共享则发布到团队市场，三者范围不同。

Rules 按用户、团队和仓库分层：个人偏好放 User Rules，跨仓库约定放 Team Rules，项目约定放 .cursor/rules/*.mdc。这些指导提供上下文，不替代环境或访问控制。

给工具明确输入输出

用 MCP 或自定义工具开放 Agent 需要的系统能力，并观察它如何使用。官方建议把常见服务操作封装成易用 CLI：必需参数明确、失败原因清晰、日志聚焦有效信息，减少模型遗漏参数或被噪声干扰。

任务完成后要求可复现的测试命令、结果和无法验证的部分。首次运行成功后再扩展自动化，避免把环境缺失反复当作编码失败。