一人公司开新项目最慢的不是写代码,是搭骨架。本教程用Claude Code在30分钟内输出含目录结构、README、.env示例、Makefile命令集和GitHub Actions的完整骨架,复用率80%以上,每个新项目节省2小时初始化工作。
适用场景
一人公司一周可能开2-3个验证型项目,每次都从零搭:
- `mkdir` 项目目录 → 想 README 怎么写 → 配 `.env.example` → 想 Makefile 命令 → 配 CI → 半天过去了,还没写一行业务代码。 - 老项目骨架要么忘了、要么和新需求不匹配,复制改改还容易留下旧名字。 - 每次「想用 Claude Code 帮搭」,但 prompt 不固定,结果每次输出风格都不一样。
本教程教你把骨架搭建动作固化成一次 Claude Code 会话,30分钟产出可立即开工的项目结构,覆盖:目录、README、依赖、命令、CI、贡献说明。
操作步骤
第1步 · 准备项目元信息(3分钟)
在新建目录里建一个 `_meta.md`,回答4个问题:
```text 1. 项目一句话定位(who + what + how) 2. 技术栈(语言/主框架/数据库) 3. 部署目标(本地 / Vercel / Docker / 其他) 4. 你是否需要 CI(PR 时自动跑测试 / lint) ```
这一步是骨架质量的天花板。`_meta.md` 越具体,Claude Code 一次成型的概率越高。
第2步 · 启动 Claude Code 并加载骨架 Prompt(2分钟)
在项目目录运行 `claude` 进入 Claude Code,把下面「代码或模板」一节的 Prompt 整段粘进去。Prompt 末尾留了 `<<META>>` 占位,把 `_meta.md` 的内容贴进去替换。
第3步 · 让 Claude Code 一次性生成所有文件(10分钟)
Claude Code 会按以下顺序写文件:
1. `README.md`(含徽章、安装、运行、目录结构、贡献说明) 2. `.gitignore`(按技术栈匹配) 3. `.env.example`(列出所有必需变量,含注释) 4. `Makefile`(封装 `install / dev / test / lint / build`) 5. `.github/workflows/ci.yml`(PR 触发 lint + test) 6. `src/` 或 `app/`(按框架建空目录 + 占位 `index.ts` / `main.py`) 7. `LICENSE`(默认 MIT,可在 prompt 里改)
运行时盯着两个点:有没有用过时的语法(比如 Node 14 时代写法)、有没有冗余文件(比如生成了不需要的 docker-compose)。
第4步 · 人工校对3个高频问题(5分钟)
Claude Code 默认输出常踩的坑,盯紧这3点:
- `.env.example` 里有没有把真实密钥写进去:让 Claude 用 `your-key-here` 占位,不要从你的 shell 历史里抄。 - Makefile 在 Windows 上能不能跑:默认会用 bash 语法,OPC 单人开发常切环境,建议要求「同时兼容 macOS 和 Git Bash on Windows」。 - README 的「安装」步骤是否真的能复现:照着自己 `make install` 走一遍,断了就让 Claude 修。
第5步 · 沉淀为脚手架命令(10分钟,一次性投入)
第一次跑通后,把整套 prompt 和 `_meta.md` 模板存到 `~/skill-templates/project-skeleton/` 下,并加一个 `init.sh`:
```bash #!/bin/bash NAME=$1 mkdir -p $NAME && cd $NAME cp ~/skill-templates/project-skeleton/_meta.template.md _meta.md echo "已生成 $NAME 项目骨架占位,请编辑 _meta.md 后运行 claude" ```
下次新项目:`init.sh my-new-tool` → 改 `_meta.md` → 开 Claude Code 粘 prompt → 完工。全流程压缩到 30 分钟以内,且每次产出风格一致。
代码或模板
Claude Code 骨架生成 Prompt(核心模板)
```text 你是「一人公司项目骨架生成器」。请基于下面的 _meta.md 内容,一次性生成一个最小可工作的项目骨架。
输入
<<META>>必须输出的文件(按顺序)
1. README.md - 顶部一句话定位(来自 _meta.md 第1条) - 「快速开始」3 步:clone / install / run - 「目录结构」用 tree 风格展示 - 「贡献」段落写明:「这是一人公司项目,PR 请先开 issue 描述场景」 2. .gitignore(按技术栈,最少覆盖:依赖、构建产物、IDE、env、日志) 3. .env.example(每个变量一行注释说明用途,全部用 `your-xxx-here` 占位) 4. Makefile,包含命令:install / dev / test / lint / build / clean 要求:兼容 macOS 和 Git Bash on Windows,每条命令前一行用 `## 说明` 注释 5. .github/workflows/ci.yml(PR 触发,跑 lint + test,缓存依赖) 6. src/ 或 app/ 目录骨架(按技术栈建空目录 + 一个占位入口文件) 7. LICENSE(默认 MIT,作者写「一人堂 OPC」)输出约束
- 不要生成 docker-compose、k8s、helm,除非 _meta.md 第3条明确要求 Docker。 - 不要写「TODO」「待补充」,所有占位用 `your-xxx-here` / `<your-name>`。 - README 不出现「赋能」「一站式」「打造」等套话。 - 全文不写中英混杂的句子(中文段就纯中文,代码块外保持一致)。输出格式
请先列出将创建的文件清单,等我回复 OK 后再写文件。 ````_meta.template.md` 模板
```markdown
项目元信息
1. 一句话定位:(who)+(what)+(how),例如「给做副业接单的开发者批量生成发票PDF的小工具」。 2. 技术栈:语言 / 框架 / 数据库 / 关键依赖。 3. 部署目标:本地 / Vercel / Cloudflare Workers / Docker / 自建VPS。 4. 是否需要 CI:是 / 否(是的话指明跑 lint 还是 test 或都跑)。 5. License:默认 MIT。 ```
复盘要点
- 骨架是杠杆,业务才是肉:30分钟搭好骨架,意味着你能在「想法-原型」之间跑更多次。一人公司的优势是迭代速度,不是单次质量。 - `_meta.md` 是合同:Claude Code 的输出质量 = `_meta.md` 的信息密度。第1条「一句话定位」越具体,后面所有文件越对齐。 - 「先列清单再写文件」是抗幻觉护栏:让 Claude 先列将创建的文件,你能在浪费 token 之前 catch 掉「为什么要建 docker-compose」这类问题。 - 沉淀为脚手架命令:第一次跑通投入 30 分钟,从第二个项目开始就是 5 分钟改 meta + 5 分钟校对,节省的时间复利。 - 不要让 Claude 写业务代码:本流程的边界是「骨架」。业务逻辑用 Claude Code 的 agent 模式另起一段 prompt,骨架阶段越纯粹越好复用。