用途:为仓库生成结构化、项目专属的 CLAUDE.md,避免上下文空白或每次会话重复解释项目背景。触发词包括“create a CLAUDE.md”“generate project context”“run the claude-md-starter skill”,或在用户粘贴近空白 CLAUDE.md 时自动触发;触发后立即执行,不先提问。
工作流共 6 步。1 检测:检查根目录 CLAUDE.md,不存在或不超过 200 字符视为空白继续;超过 200 字符则先做 diff-and-merge,列出 8 个必需分区的 NEW、ENHANCED、SAME、CONFLICT 对比表,提供 A(保留原内容并追加)、B(整体替换)、C(逐段确认)三种选择。2 扫描:并行读取信号文件,如 package.json、pyproject.toml、Cargo.toml、go.mod、Makefile、.github/workflows/.yml、Dockerfile、.eslintrc.、ruff.toml、jest.config.*、tsconfig.json、.env.example、README.md 前 40 行、顶层目录和 .gitignore 等。3 推断:从扫描结果填充项目概述、技术栈、命令、架构、代码约定、测试、禁做事项、环境搭建等分区。4 追问:仅对无法推断的内容提问,最多 3 个,一次发出。5 生成:按模板写入,命令须真实可运行,禁止占位符,禁做事项至少 2 条,采用祈使句。6 校验:确认各分区有实际内容、命令不少于 2 条、无未替换占位文本、合并流程已完成。
限制与反模式:不得跳过扫描直接生成,不得问超过 3 个问题,不得写“add your commands here”之类占位内容,不得覆盖已有完整 CLAUDE.md 而不走合并流程,不得包含未在信号文件中出现且未经用户确认的命令。
适用场景:新仓库初始化项目上下文、团队统一 Claude 会话背景、快速补齐已有 CLAUDE.md。参考资料包括 references/scan-signals.md、references/claude-md-template.md、references/validation-checklist.md。版本 1.0.0。收费、平台支持与安装方式暂未提供。