SuperAPI AI 工具集

md-starter

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:为仓库生成项目专属的 CLAUDE.md,为 Claude 提供完整项目上下文。触发方式包括显式请求(如“create a CLAUDE.md”“generate project context”“initialize CLAUDE.md”)以及隐式场景(用户粘贴近乎空白的 CLAUDE.md 要求填充,或反复在会话开头重述项目背景)。触发后立即运行,扫描前不提问。

工作流共 6 步:1 检测 CLAUDE.md 是否存在及长度;2 扫描根目录信号文件(package.json、pyproject.toml、Cargo.toml、Makefile、.github/workflows、Dockerfile、eslint/prettier/ruff 配置、测试配置、tsconfig.json、.env.example、README 前 40 行、顶层目录、.gitignore);3 推断可推导的章节;4 最多提 3 个无法推断的问题,一次性提出;5 按模板生成 CLAUDE.md;6 校验必填章节非占位。

若已有 CLAUDE.md 超过 200 字符,先走 diff-and-merge 流程:逐章节分类为 NEW、ENHANCED、SAME、CONFLICT,展示差异表,并提供三种选项——A 保留现有内容仅追加新增与增强章节(推荐)、B 完全替换、C 逐节审查冲突后再写。

生成规则:每个填充章节必须有真实内容,不得留占位符;无法填充的章节直接省略;命令必须精确可运行(如 npm run dev);What NOT To Do 至少 2 条;使用祈使句直述风格;章节内标题不超过 H2。写入项目根目录 CLAUDE.md 后输出一行确认。

限制与反模式:不得未扫描就生成;不得提超过 3 个问题;不得写占位章节;不得在未走 diff-and-merge 的情况下覆盖已有内容的 CLAUDE.md;不得写与项目无关的通用模板;不得包含信号文件中未找到且用户未确认的命令。参考资料包括 scan-signals.md、claude-md-template.md、validation-checklist.md。版本 1.0.0。