init-projectlisted
Install: claude install-skill huangwb8/skills
# Init Project
## 与 bensz-collect-bugs 的协作约定
因本 skill 设计缺陷导致的 bug,先用 `bensz-collect-bugs` 记录到 `~/.bensz-skills/bugs/`,不要直接改用户本地已安装源码;若有 workaround,先记 bug 再继续。只有用户明确要求公开上报时,才用本地 `gh` 上传到 `huangwb8/bensz-bugs`;不要 pull / clone 整个仓库。
## 目标与边界
为当前项目生成标准 AI 协作文档,让 Claude Code / OpenAI Codex CLI 等工具理解项目目标、工程原则、变更记录规则与协作边界。
只允许在当前工作目录及其子目录内创建或修改文件。禁止写入父目录、其它项目、系统目录或用户级配置。脚本会在写入前校验输出路径,失败时立即停止。
## 输出文件
- `AGENTS.md`:跨平台通用项目指令,Single Source of Truth;必生成,智能合并。
- `CLAUDE.md`:Claude Code 适配层,核心为 `@./AGENTS.md`;必生成,智能合并。
- `README.md`、`CHANGELOG.md`、`.gitignore`:按需生成;`--overwrite` 可覆盖/合并。项目变更必须维护 `CHANGELOG.md`。
- `docs/`、`docs/plans/`:完整初始化时自动补齐;计划文档固定放在 `./docs/plans/`。
- `docs/contribution.bac`:默认 BAC 账本;`--bac-file` 可改,`--disable-bac` 可关。
## 核心约束
- `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/`。
- 代码变化导致 `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: