用途：自动化 CLAUDE.md 的生命周期管理，包括从项目配置与模板生成、增量更新标记区块，以及为提升 token 效率而重构。
主要能力：三种模式——init（无 CLAUDE.md 时按模板+配置全新生成）、update（仅替换标记之间的内容，保留其余部分）、refactor（纯 AI 优化，去冗余、改结构）。使用 <!-- SECTION:key --> 标记实现增量更新；条件区块仅在配置含对应数据时生成，无数据则省略。生成文件包含通用会话指南并写入 sentinel 标记，供 bootstrap 门禁识别完整性。
使用方式：先确保存在 docs/project-config.json 与 Node.js。检测模式：node .claude/skills/claude-md-init/scripts/generate-claude-md.cjs --detect；生成：node .claude/skills/claude-md-init/scripts/generate-claude-md.cjs --mode init（或 --mode update）。脚本读取配置与模板，写入 CLAUDE.md 前创建备份。之后由 AI 补充项目描述、黄金规则等创造性内容，再校验标记配对、无占位符残留。CLAUDE.md 写完后需调用 $sync-codex 重新生成 AGENTS.md 与 Codex 镜像。
适用场景：任何含 docs/project-config.json 的项目，用于初始化或维护 CLAUDE.md 及下游镜像。
限制：依赖 Node.js 与配置文件；refactor 模式无脚本、纯 AI 执行；缺失标记的更新会跳过该区块；若某步骤或工具在当前环境无法运行，需先停止并询问用户。具体收费、平台支持等信息暂未提供。