{"slug":"init-project","title":"init-project","summary":"当用户明确要求\"初始化项目\"、\"创建项目指令文件\"或\"生成 AGENTS.md\"时使用。完全自动化：自动检测操作系统默认语言，分析项目目录结构（支持 Python/Web/Rust/Go/Java/数据科学/文档项目等），推断项目类型和用途，一键生成规范的项目指令文档。生成结果包括：AGENTS.md（跨平台通用项目指令，Single Source of Truth）、CLAUDE.md（Claude Code 特定适配，通过 @./AGENTS.md 引用）、README.md（项目介绍与使用方法）、CHANGELOG.md（项目变更记录）、.giti","platform":"Claude","tags":["claude-code"],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-27T17:01:25.435697Z","repo":{"url":"https://github.com/huangwb8/skills","stars":48,"forks":8,"license":"MIT","updatedAt":"2026-09-25T04:25:50Z"},"bodyHtml":"

Init Project

\n

这个 skill 用来为当前项目初始化标准化的 AI 协作文档和基础仓库文件，适合新项目起步或已有项目补齐指令体系；它只应该在当前项目目录内工作，不应越界修改其它目录。

\n

用法

\n

最推荐用法

\n
请使用 init-project skill 为本项目进行初始化。\n输入：当前项目根目录\n输出：`AGENTS.md`、`CLAUDE.md`、`README.md`、`CHANGELOG.md`、`.gitignore`、`docs/`、`docs/plans/`\n
\n

进阶用法

\n
请使用 init-project skill 为本项目进行初始化。\n输入：当前项目根目录\n输出：标准化项目指令与说明文档\n另外，还有下列参数约束：\n- 尽量保留已有内容\n- 默认语言自动检测\n- 不修改当前目录之外的文件\n
\n

能做什么

\n\n

使用示例

\n

示例 1：初始化一个新项目

\n
请使用 init-project skill 为本项目进行初始化。\n输入：当前项目根目录\n输出：完整的项目指令文件与说明文档\n
\n

示例 2：为已有项目补齐协作文档

\n
请使用 init-project skill 初始化这个已有仓库。\n输入：当前项目根目录\n输出：`AGENTS.md`、`CLAUDE.md`、`README.md`、`CHANGELOG.md`、`.gitignore`、`docs/`、`docs/plans/`\n另外，还有下列参数约束：\n- 尽量保留已有 README 的有效信息\n- 不破坏现有项目结构\n
\n

示例 3：只补某一类文档

\n
请使用 init-project skill 为本项目补齐说明文档。\n输入：当前项目根目录\n输出：README 或 CHANGELOG\n另外，还有下列参数约束：\n- 只更新 README\n
\n

输出

\n\n

配置

\n\n

备选用法（脚本/硬编码）

\n

如果你想直接在命令行下执行项目初始化，脚本入口最方便。

\n

自动分析当前目录并生成文件

\n
python3 init-project/scripts/generate.py --auto\n
\n

自动分析并覆盖已有文件

\n
python3 init-project/scripts/generate.py --auto --overwrite\n
\n

只生成部分文档

\n
python3 init-project/scripts/generate.py --auto --only-readme\npython3 init-project/scripts/generate.py --auto --only-changelog\n
\n

跳过部分输出

\n
python3 init-project/scripts/generate.py \\\n  --auto \\\n  --skip-readme \\\n  --skip-changelog \\\n  --skip-gitignore\n
\n

BAC 贡献记录

\n
# 默认开启：检查/安装 bac，并初始化 docs/contribution.bac\npython3 init-project/scripts/generate.py --auto\n\n# 指定项目内的其它 BAC 文件\npython3 init-project/scripts/generate.py --auto --bac-file docs/audit/contribution.bac\n\n# 随时显式关闭 BAC 初始化步骤\npython3 init-project/scripts/generate.py --auto --disable-bac\n
\n

关闭后，生成的 AGENTS.md 会明确 BAC 当前未启用，不再保留“默认且强制”的启用态指令。

\n

BAC 基于 https://github.com/huangwb8/bensz-auto-contribution，用于客观记录人类与 AI 的协作过程和证据，不替代最终署名、责任或合规判断。

\n

常见问题

\n

Q：AGENTS.md 和 CLAUDE.md 到底谁是主文件？

\n

A：AGENTS.md 是单一真相来源；CLAUDE.md 是平台适配层。维护时应优先保证 AGENTS.md 的口径正确。

\n

Q：它会不会改到当前项目目录之外？

\n

A：不应该。这个 skill 的边界就是“当前目录内生成或更新项目文件”。

\n

Q：既然是自动化，是不是可以放心覆盖任何已有文件？

\n

A：不能这么理解。自动化不等于无脑覆盖。是否覆盖应由你显式决定，例如使用 --overwrite。

\n

Q：为什么 .gitignore 也算初始化结果的一部分？

\n

A：因为它直接关系到项目安全和仓库整洁度，尤其能防止敏感文件、系统文件和缓存文件被误提交。

\n","files":[{"path":"CHANGELOG.md","sizeBytes":13082,"isText":true},{"path":"config.yaml","sizeBytes":4071,"isText":true},{"path":"README.md","sizeBytes":5559,"isText":true},{"path":"scripts/generate.py","sizeBytes":66606,"isText":true},{"path":"scripts/test_console_encoding.py","sizeBytes":6692,"isText":true},{"path":"SKILL.md","sizeBytes":10196,"isText":true},{"path":"templates/AGENTS.md.template","sizeBytes":5201,"isText":false},{"path":"templates/CHANGELOG.md.template","sizeBytes":986,"isText":false},{"path":"templates/CLAUDE.md.template","sizeBytes":411,"isText":false},{"path":"templates/gitignore.yaml","sizeBytes":5198,"isText":true},{"path":"templates/README.md.template","sizeBytes":1270,"isText":false}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"notes-only","suspicious":0,"notes":3,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-08T11:57:31.727259Z","sha256":"61D3D3674EFB002D24376528D7D5F1189A344DC11E89688948DBA5BC1583BA47","sizeBytes":42086},"review":null,"source":{"repositoryUrl":"https://github.com/huangwb8/skills","path":"skills/alpha/init-project","license":"MIT","commit":"9cba9fd64cd22f38af2c2503a11d8247be2090cd","subtreeSha":"811D9D26AF8DEDF6E9CE357D344CFF246BB7002AAFB7C40702E74434307392BA","lastSyncedAt":"2026-09-25T07:37:25.617865Z"},"reviewedAt":"2026-09-08T12:08:03.422632Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/huangwb8/skills/tree/main/skills/alpha/init-project"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install huangwb8-skills@llmmart"},{"target":"git","command":"git clone https://github.com/huangwb8/skills.git"}]}