ai-workspace-template

让 Agent 不只完成一次任务，而是持续维护一个可信、可验证、可回滚的工作区。

一句话开始 · 工作方式 · 完整指引 · 安全边界

一句话开始

[!IMPORTANT] 把下面整句话直接发给能访问公开网页、读取本地文件并执行终端命令的 Agent；把【目标目录】替换成实际路径，或者保留“默认当前目录”。

使用方式： 直接把上面这句话发给 Agent 即可；Agent 会先阅读公开模板仓库，再处理你给出的目标目录，不要求你预先克隆模板。你也可以先点击 GitHub 的 Use this template 创建自己的仓库，再把“目标目录”保留为当前目录。这个入口不依赖特定模型、斜杠命令或聊天产品。

这是一个面向真实工作的 AI 工作区模板。它适合软件项目、研究、内容生产、个人运营，以及任何会不断积累文件、决定、经验和自动化的长期事务。

很多工作区一开始都很轻松：先建几个文件夹，想到什么就让 AI 写什么。时间一长，问题才慢慢出现——草稿和正式成果混在一起，README 与实际状态对不上，失败过程找不到，自动化到底有没有运行也没人说得清。AI 越能干，混乱往往来得越快。

这个模板想解决的就是这件事：给人和 AI 一套简单、可检查的共同工作方式。

当前版本：0.1.0-alpha.2。已经可以用于新工作区和现有工作区的安全接管；公开契约仍可能在 0.1.0 前调整。

它会怎样改变你的工作方式

它不会要求 AI 记住所有事情，而是让重要信息在合适的阶段留下来：

• 新想法有临时落脚处，不会一开始就被包装成“正式项目”。
• 长期项目、常驻服务和复用工具有各自的责任与完成标准。
• AI 做过的测试、失败和关键决定都有证据可追，不靠聊天记忆。
• 文档、状态和实际文件会定期对账；发现漂移，就修复或明确记成有负责人、有期限的债务。
• 真正稳定的经验可以沉淀为知识，未经验证的模型输出不会悄悄变成事实。

一项工作从哪里开始，又到哪里结束

工作先按性质落位，不确定或一次性的事情先探索；确认值得长期维护后，再经人确认“毕业”为项目、服务或工具。这比一开始猜它应该是什么，更容易保持工作区干净。

完成和退役不是一回事：完成表示承诺已经交付，退役表示对象不再维护。暂停和阻塞也不会被当作失败，它们会保留原因、负责人和恢复条件。

在实际协作里，你不必手动维护所有表格。AI 会读取当前工作项、状态和最近证据，在完成任务的同时同步受影响的说明与登记信息；收尾前再跑一次审计，确认没有留下无人负责的问题。

AI 自动维护到底会做什么

这里的“自动维护”不是让 AI 擅自整理整个硬盘，而是把维护分成清楚的边界：

这种设计的目标不是限制 AI，而是让它在可以放心行动的地方更主动，在会改变历史、外部系统或事实认定的地方停下来找你确认。

开始使用

页面最前面的单句指令已经足够启动标准流程。Agent 会先判断目标属于哪种情况，再选择对应入口：

如果希望把授权边界写得更明确，可以使用下面的完整版本。它和顶部单句遵守同一份契约，只是把各阶段展开说明。

复制这一段给 Agent

把“目标目录”替换成你的路径；如果仓库已经在 Agent 当前打开的目录里，保留“默认当前目录”即可。

这是一段话启动，不是取消安全边界。它一次性授权纯增量初始化和本地激活，因此 Agent 不需要每一步都让你回复“继续”；移动、删除、覆盖、部署、凭据、外部调度器、提交和推送仍然必须另行确认。