项目初始化

要解决什么问题

新仓库或空目录里，编码助手往往一边猜技术栈、一边批量生成文件，结果出现锁文件与包管理器不一致、指令文件与当前助手不匹配、以及把未确认的需求写进 AGENTS.md / CLAUDE.md 等问题。这个技能把项目初始化拆成「先定契约、再动手」：指令文件是后续智能体沟通规则、目录约定、安装验证和交付要求的唯一事实来源。

技能如何工作

1. 读工作区再写文件：扫描现有 AGENTS.md、README、包清单、构建配置和目录结构，识别语言、框架、包管理器与测试入口，并保留用户已有改动。
2. 选对指令文件：Codex/OpenAI 用 AGENTS.md，Claude Code 用 CLAUDE.md（或仓库已采用的 Claude 指令路径）；不确定助手或文件名时先问用户，避免同时创建两套冲突文件。
3. 语言与内容：新建前确认指令文件语言；更新时尽量保留原语言。写入内容必须可执行、简洁，且不得用猜测填补技术栈、运行时、数据库、部署或认证等空白——有歧义就先问。
4. 最小化初始化与验证：在用户明确技术栈后，只创建该栈必需的文件；优先沿用检测到的包管理器与官方脚手架。完成后跑最小但有意义的验证（依赖检查、编译、lint 或针对性测试），并给出契约摘要、已创建文件与未决事项。
5. 代码审查条款：生成的契约里会要求后续智能体在实现前后做审查，并尽量给出文件与行号。

适用边界

• 不会替用户静默选定技术栈；栈未明确时，契约会要求先让用户选择。
• 不做无关重构、大范围格式化或推测性功能；密钥只进 .env.example 占位，不写入待提交文件。
• 若工作区证据与用户需求冲突，或生成式框架涉及生成产物，会遵循「改源再生成、不手改生成文件」等规则，而不是强行覆盖。