init-project

# Init Project ## 目标 当用户明确要求初始化项目、创建项目指令文件、生成 AGENTS.md，或为已有项目补齐 AI 协作规范时使用。本 Skill 分析项目结构，并生成或更新适用于当前项目的标准化协作文档与基础目录。 ## 流程 ### 输入 输入为目标项目根目录及用户选择的初始化模式；可选输入包括项目名称/描述、工作流、输出开关、`--overwrite`、`--bac-file` 和 `--disable-bac`。输出路径必须位于当前项目目录内，现有治理文件和用户自定义章节应先识别再合并。 ### 执行步骤 #### 目标与边界 为当前项目生成标准 AI 协作文档，让 Claude Code / OpenAI Codex CLI 等工具理解项目目标、工程原则、变更记录规则与协作边界。 只允许在当前工作目录及其子目录内创建或修改文件。禁止写入父目录、其它项目、系统目录或用户级配置。脚本会在写入前校验输出路径，失败时立即停止。 #### 核心约束 - `AGENTS.md` 是唯一需要长期手动维护的通用指令源；`CLAUDE.md` 只做 Claude Code 适配，并通过 `@./AGENTS.md` 自动引用。 - 生成模板统一放在 `init-project/templates/`：`AGENTS.md.template`、`CLAUDE.md.template`、`README.md.template`、`CHANGELOG.md.template`、`gitignore.yaml`。 - 配置统一放在 `init-project/config.yaml`，版本号以 `skill_info.version` 为准；当前 BAC 配置在 `bac_contribution`。 - 完整初始化必须补齐 `docs/`、`docs/plans/` 与 `skills/`；`skills/` 只托管项目专属 Agent Skills。 - `skills/` 中的 Agent Skill 必须遵循 `huangwb8/skills` 仓库的 `AGENTS.md`，并配合该仓库的 `docs/templates` 使用；不得把通用 Skill 或无关项目代码放入其中。 - 代码变化导致 `docs/` 中非 `plans/` 文档过时时，生成的项目指令必须要求同步更新。 - 影响项目行为、结构、工作流、工程原则、指令文件或关键配置的变更，必须写入 `CHANGELOG.md` 的 `[Unreleased]`。 #### BAC 贡献记录 默认基于 `bensz-auto-contribution` / `bac` 记录人类、AI 与工具贡献证据： - 默认仓库：`https://github.com/huangwb8/bensz-auto-contribution` - 默认安装源：`git+https://github.com/huangwb8/bensz-auto-contribution.git` - 默认文件：`docs/contribution.bac` - Python 要求：`config.yaml:bac_contribution.min_python_version`，当前为 `3.10` - 默认开启；用户可随时通过 `--disable-bac` 显式关闭。关闭时生成的文档也必须说明当前已关闭且可重新启用。 - 用户通过 `--bac-file` 指定项目内其它路径时，以...