用途：为新建或已有仓库准备 AI 智能体可读的上下文文件，使 Claude Code、Codex 等工具在首次提示时即了解项目。
触发场景：用户想在新项目起始阶段就配置智能体上下文；打开已有仓库但缺少 AGENTS.md；说出“bootstrap this project”“set up agent context”或请求帮助创建 CLAUDE.md/AGENTS.md。
主要步骤：先判断新建还是已有项目——已有项目（存在源码、README 或 .git）直接进入上下文收集；新项目需询问项目名（kebab-case）、父目录位置和简要描述（用途、技术栈、约束），再 mkdir -p、cd、git init 并按技术栈生成 .gitignore。接着做覆盖保护：若 AGENTS.md 已存在需先确认再覆盖；CLAUDE.md 存在且不是指向 AGENTS.md 的符号链接则先询问；agent_docs/ 已存在则跳过创建并说明。然后只读收集 README、package.json/pyproject.toml/Cargo.toml/go.mod、顶层目录、CI 配置等，新项目则用用户描述。若检测到数据管道/分析项目（dlt、sqlmesh、polars、duckdb 依赖，.duckdb 文件，ingest/ 或 transform/ 目录等），建议采用 ingest/、transform/、notebooks/、data/ 布局并写入 AGENTS.md，同时提示使用 /data-pipelines 技能；已有不同布局只记录不改动。写 AGENTS.md 需包含标题、一句话用途、技术栈、目录结构表、关键命令（仅限真实存在的构建/测试/检查/开发命令）、约定、注意事项，省略不适用小节，不留占位符。随后执行 ln -s AGENTS.md CLAUDE.md，并 mkdir -p agent_docs 且添加 README.md 使目录被 git 跟踪。最后打印所创建内容的摘要与后续建议。
限制：全部基于本地文件推断，不修改源码；AGENTS.md 内容取决于现有资料，资料缺失处不应编造；覆盖已有文件前必须询问。