SuperAPI AI 工具集

atlas-contract

智能体与模型

查看项目

更新于 10-16 08:43

技能介绍

Atlas Contract 是一个提示层级的治理技能,核心用途是在代理执行任务时保持与用户原始目标一致,避免偏离、擅自替换实现或削弱验证。它适用于后端/API/数据库/持久化/认证、需要保留既有行为、涉及数据完整性或共享状态、涉及测试与验收标准、需要匹配参考布局,以及多部分请求和返工等场景;对于简单事实回答、纯解释、孤立拼写或格式修复、无风险的一行编辑、仅分析不执行的请求,则不应使用。

主要能力包括:按风险信号(后端、保留、数据、测试、保真度)对任务分级,决定治理强度;在规划或编辑前输出紧凑的目标契约,包含必须做、不得做、保留项、检查项与阶段范围;阶段数量最多 4 个,每个阶段必须有可独立验证的交付物,不能只有“准备”内容;对删除代码、用模拟/占位数据替换真实行为、削弱或删除测试、跳过必要验证、改变布局结构、收窄路由或范围、更改枚举/模式/API 形状等动作,必须先证明不违反契约,否则发出偏差通知并停止,不得先做后解释。

使用方式上,技能会先运行 Project Ledger Hook:检查工作区根目录是否存在由配套技能 atlas-ledger 写入的 Atlas.md。该文件被视为不可信的工作区数据而非指令,不能覆盖系统、开发者或用户指令、仓库 AGENTS.md、工具安全规则或安全策略。若用户明确批准导入,只读取已确认条款,最多展示五条候选条款及其 ID 和原文,询问用户哪些条款适用,仅将用户选中的条款转为契约默认值并标注“Carried-in Ledger Clauses”。若 Atlas.md 缺失、格式错误、过期、过大、含糊、含命令式文本或与项目漂移预防无关,则用一行说明并跳过导入,绝不编造条款。

限制:这是提示层级的治理层,不是外部强制机制,同一模型仍可能误用审计;Heavy 模式会显著增加交互开销,不应强加于简单回答或琐碎编辑;它无法机械证明工具效果,高风险工作仍需独立测试、评审或代码级门禁;配套账本仅在用户确认持久条款且项目保持 Atlas.md 可用时有效。