← ClaudeAtlas

init-projectlisted

当用户明确要求"初始化项目"、"创建项目指令文件"或"生成 AGENTS.md"时使用。完全自动化:自动检测操作系统默认语言,分析项目目录结构(支持 Python/Web/Rust/Go/Java/数据科学/文档项目等),推断项目类型和用途,一键生���规范的项目指令文档。生成结果包括:AGENTS.md(跨平台通用项目指令,Single Source of Truth)、CLAUDE.md(Claude Code 特定适配,通过 @./AGENTS.md 引用)、README.md(项目介绍与使用方法)、CHANGELOG.md(项目变更记录)、.gitignore(Git 忽略规则,安全优先),并在完整初始化时自动补齐 `docs/` 与 `docs/plans/`。
huangwb8/skills · ★ 39 · AI & Automation · score 86
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: