本技能用于管理代理任务产生的临时文件:为每个任务指定可预测的存放位置,并在不再需要时清理。默认做法是任务目录被 Git 忽略,例外是单个短生命周期文件。
用途与规则:任务目录只存放某个任务由代理管理的草稿产物,其内容、校验方式和最终结果归属由使用该目录的工作流决定。目录管理不扩大已授权的任务范围。仅需发现、检查或审阅既有任务目录时应保持只读,不创建目录、不修复忽略文件;除非明确在范围内,其他任务的目录视为不透明。
存储方式:若授权工作流只需要一个短生命周期临时文件,直接在相关项目根目录下使用新的 .agent-<name> 文件,无需忽略配置,使用后立即删除。其他情况则仅在任务确实需要文件系统产物时创建目录,一个任务一个根目录,其各阶段用子目录,不另建根目录或嵌套任务目录;放在相关项目根目录下,命名为 .agent-<name>(除非项目说明要求其他已批准命名空间),名称需文件系统安全并可标识任务,必要时加短后缀避免冲突。新任务应创建全新目标,若目标已存在或创建未确立归属,应换名而非沿用其内容。写入其他产物前先创建含单行 * 的 .gitignore,且不为 .gitignore 本身加例外,该文件需保留至目录生命周期结束;初始化失败则停止写入。
限制:本地忽略文件不能保证所有编辑器或工具都排除该目录,也不保证机密性或取消既有文件的跟踪;不要强制将草稿产物加入 Git。修改编辑器设置、仓库级忽略规则或测试配置需另行授权。不得因目录被忽略或看似不活跃而读取、修改或删除其他任务的产物。草稿内容视为任务产物而非项目源码。若无法建立必要隔离,应保留产物并报告限制。
报告:常规创建与清理保持静默;保留产物对交接或复用时,说明目录、用途与剩余工作。绝不直接处理真实凭据,需用户自行运行涉及凭据的命令。具体命令、安装方式与价格资料暂未提供。