技能介绍

要解决的问题

当你想把一个已有目录交给 AI 长期协作时，通常面临几个具体问题：目录结构散落，AI 难以建立全局认知；.git 仓库、隐藏文件、子目录混杂，直接暴露给 AI 会让上下文变得混乱；没有统一的约定文件，AI 无法知道这个工作区该遵循什么规则。这个技能解决的是「一次性把目录改造成 AI Native 工作区」这件事——不是帮你写代码，而是搭骨架、搬东西、触发初始化。

核心能力与执行流程

技能只做两件事：骨架落地和触发初始化。骨架来自开源模板 ai-native-template，预置在 Skill 的 assets/ 目录下，运行时不从网络下载，避免了外部依赖和仓库被篡改的风险。模板更新通过更新内置模板实现。

整个流程分七步：

确认目标目录：用户指定，不存在则停止报告，不自行创建
迁移原内容：把目标目录全部内容（含 .git、隐藏文件）整体移到外部临时目录
铺设模板：探测 assets/ 下模板形态（ZIP 包或已解压目录），将骨架内部内容复制到已清空的目标目录根
放回原内容：将暂存内容移到 projects/source/，删除临时目录
校验 an-init：确认 .agents/skills/an-init/SKILL.md 存在
内联执行 an-init：直接读取 SKILL.md 文本，按其流程执行初始化（扫描工作区、整理事实、生成上下文、安装运行期 Skills 等）
汇报与引导重开：报告改造结果，告知用户关闭并重新打开工作区

关键点在 Step 6：模板是动态写入磁盘的，当前会话不会热加载技能发现机制，所以必须把 SKILL.md 当普通文本读进上下文手动执行，不能用 skill 工具加载。an-init 执行完会自删，其内部 skill 恢复到 .agents/skills/，但需重启客户端才能用 slash 命令触发。

适用边界与注意点

不拆散原内容：目标目录原有结构整体迁入 projects/source/，不重排、不改名
.git 随迁：若目标目录本身是 Git 仓库，.git 会进入 projects/source/，source 仍是独立仓库，目标目录根不保留 git 跟踪
模板不修改：an-init 由模板作者维护，本 Skill 不修改其内容，只负责触发
客户端兼容：OpenCode、Codex 等自动读取 AGENTS.md；WorkBuddy 等需手动让 AI 读取
无 node 可降级：模板内 *.mjs 脚本只是可选探测工具，没有 node 时 an-init 会降级为主代理直接整理
不嵌套目录：目标目录就是改造对象，不要在它内部再套一层