Scaffold

/scaffold

在已存在的项目目录里就地铺设方法论脚手架。全程默认中文输出（技术标识符保持英文）。

模板位于本 skill 的 templates/ 子目录。用 Glob/Read 读模板时，基于调用时给出的本 skill base directory（"Base directory for this skill"）下的 templates/，不要写死绝对路径。

技术栈基线（固定，不做选型）

后端技术栈固定为 Go，版本与选型统一采用以下基线（固定基线是本方法论的一部分：逐项目不再重复选型；想换栈就修改本表，而不是单次临时偏离）：

组件	选型 / 版本	说明
后端语言	Go 1.25（golang:1.25-alpine 编译）	标准库 net/http + chi 路由，无重量级框架
DB 访问	pgx（手写 repository）	不用 ORM、不用 sqlc，internal/repo 直接写类型化 SQL
迁移	golang-migrate	纯 SQL 版本化迁移（NNNN_*.up.sql / down.sql）
校验/序列化	encoding/json + go-playground/validator	请求/响应 schema 校验
前端（如需要）	React + TypeScript + Vite	node:20-alpine 仅用于构建阶段
运行镜像	alpine:3.20	Docker 多阶段构建，单静态二进制，/health 健康检查
目录结构	backend/cmd/server 入口 + backend/internal/{config,db,repo,handlers,service,model,middleware}	Go 社区惯例；前端在 frontend/src

后端服务保持无状态（状态全在数据库），为多副本水平扩展留余地。

步骤 1：确认项目名与目录

basename "$PWD"

取当前文件夹名为项目名。确认当前目录就是要铺设的项目根目录。

步骤 2：Intake — 收集项目意图

向用户说明并收集：

把这个项目的想法 / 会议总结讲给我，或指给我一个文件（如纪要 *.md），我据此判断技术栈、数据库、核心不变量和模块划分。

• 用户给文件路径 → 用 Read 读它；若是会议纪要，落盘时将原始内容归档进 docs/MEETINGS.md 第一节
• 用户口述 → 用对话内容
• 信息不足以判断时，针对性追问（不要泛泛）

步骤 3：决策并确认

基于 intake，向用户列出以下各项 + 给理由，用 AskUserQuestion 让用户确认/修改：

1. 后端技术栈 —— 固定为 Go，不询问、不选型（见开头「技术栈基线」表格）。只向用户陈述将采用该基线；若用户主动要求换栈，视为修改本 skill 的信号，提醒其更新基线表而非本次临时偏离
2. 数据库：
   • 默认 PostgreSQL（有并发 / 大多数场景；Go 侧用 pgx + golang-migrate，见基线表）
   • 仅小型低并发 / 单机一体机用 SQLite（如 mac mini appliance）
   • 判断依据：并发量、部署形态（云 vs 单机）、数据规模
3. 是否需要 Web 前端：需要则按基线 React + TypeScript + Vite；纯 API / CLI 项目则无 frontend 目录
4. 核心不变量：本项目「绝不破坏」的架构约束，0~N 条。想不出就留占位
5. 模块划分：顶层模块名 + 一句话职责。想不清就留占位

把每项的判断理由说出来，由用户拍板。确认后才落盘。

步骤 4：落盘（带冲突保护）

先列出将写入的 10 个目标文件，逐个检查是否已存在：

for f in .claude/CLAUDE.md docs/PLAN.md docs/Progress.md docs/ARCHITECTURE.md docs/DEPLOYMENT.md docs/REQUIREMENTS.md docs/DECISIONS.md docs/MEETINGS.md .gitignore README.md; do
  test -e "$f" && echo "EXISTS: $f"
done

• 有 EXISTS 的 → 列出来问用户：跳过 / 备份改名（.bak）/ 手动合并。绝不静默覆盖
• 无冲突的 → 继续

对每个模板：Read 模板内容 → 替换占位符 → Write 到目标路径。占位符替换表：

占位符	值来源
{{PROJECT_NAME}}	步骤 1 文件夹名
{{ONE_LINER}}	intake 提炼的一句话定位
{{DATE}}	date +%F
{{TECH_STACK}}	固定基线：Go 1.25（net/http + chi）+ pgx + golang-migrate；有前端时追加 ；前端 React + TypeScript + Vite（Node 20 构建）
{{DATABASE}}	步骤 3 数据库
{{INVARIANTS_BLOCK}}	步骤 3 核心不变量；无则 <!-- 待补：本项目核心不变量 -->
{{MODULES_BLOCK}}	步骤 3 模块划分；无则 <!-- 待补：模块划分 -->
{{CODE_CONVENTIONS_BLOCK}}	按基线生成的 Go 代码约定（Go 1.25、gofmt、error 显式处理并 wrap、cmd/ + internal/ 布局、依赖最小化）；有前端时追加 TS 约定（strict 模式、组件按页面分目录）

模板路径映射：templates/docs/X.md.tmpl → docs/X.md；templates/gitignore.tmpl → .gitignore；templates/CLAUDE.md.tmpl → .claude/CLAUDE.md；templates/README.md.tmpl → README.md。另建空目录占位 data/.gitkeep。

内容预填（不只替换占位符，能填实的就填实）：

• docs/REQUIREMENTS.md：用 intake 提炼内容尽量填实（产品定位、目标用户、分期路线图、已确认决策）；填不了的保留待补注释
• docs/MEETINGS.md：intake 来自会议纪要时，把原始纪要归档为第一节；否则保留空骨架
• docs/DECISIONS.md：模板自带「Go 基线」首条；步骤 3 若有其他重要拍板（如数据库选 SQLite 的理由），各追加一条 What/Why/Changes

步骤 5：收尾

git rev-parse --git-dir >/dev/null 2>&1 || git init
git add -A
git commit -m "chore: 初始化项目脚手架"

落盘后自检：

grep -rl '{{' .claude docs README.md 2>/dev/null && echo "⚠ 有未替换占位" || echo "占位全部替换 ✓"
LC_ALL=C grep -rl $'\xef\xbf\xbd' .claude docs README.md 2>/dev/null && echo "⚠ 有乱码" || echo "无乱码 ✓"

向用户汇报：生成了哪些文件、技术栈/DB 决策、下一步建议（/brainstorming 开始设计——spec 获批后直接 ultracode 实现，或直接开干）。