refactor: skill 改为自包含(符合工业惯例),install 简化为整目录拷贝

- .claude/skills/new-project/ 自带 scripts/verify.sh:拷了即用、可移植,
  不再依赖 install 时从根 scripts/ 组装
- install-skill.sh 简化:本地整目录 cp -R / 远程按清单拉取
- check-docs.sh 增加一致性校验:根 scripts/verify.sh 与 skill 内副本必须相同
  (改了根副本需同步,CI/本地都会报漂移)
- README 更新 skill 自包含说明 + 文件树

取舍:接受 verify.sh 两份小重复,换 skill 自包含可移植——符合 Anthropic skills 惯例,
比'安装时组装'更专业、更好维护;漂移由 CI 兜底。
This commit is contained in:
baozaotumao
2026-06-02 01:07:04 -07:00
parent e07d57eea1
commit 871e0589cd
4 changed files with 394 additions and 27 deletions
+7 -6
View File
@@ -26,7 +26,7 @@ curl -fsSL https://raw.githubusercontent.com/baozaotumao2025/scaffold/main/scrip
可用 preset`principles`(仅规则)· `fullstack` · `fullstack-ai` · `api-only`
> 模板由 copier 从 GitHub 实时拉取。`verify.sh` 在仓库根 `scripts/` 单一维护,安装时由 `install-skill.sh` 组装进 skill,使安装后的 skill 自包含
> 模板由 copier 从 GitHub 实时拉取。skill 目录 `.claude/skills/new-project/` **自包含**SKILL.md + scripts/verify.sh),安装即整目录拷贝,符合 skill 可移植惯例
---
@@ -139,12 +139,13 @@ backend/src/ agent/src/ frontend/sr
scaffold/
├── copier.yml ← 问卷变量 + 条件排除逻辑
├── README.md
├── .claude/skills/new-project/
── SKILL.md ← skill 元数据 + 生成指令verify.sh 安装时组装)
├── .github/workflows/docs-check.yml ← scaffold 自身 CI:防 README 与 template 漂移
├── .claude/skills/new-project/ ← 自包含 skill(拷了即用,符合惯例)
── SKILL.md ← skill 元数据 + 生成指令
│ └── scripts/verify.sh ← skill 自带(与根 scripts/verify.sh 同步,CI 防漂移
├── .github/workflows/docs-check.yml ← scaffold 自身 CI:防文档/verify.sh 漂移
├── scripts/
│ ├── verify.sh ← 工具链合规检查(幂等只读,单一源
│ ├── install-skill.sh ← skill 安装到 ~/.claude/skills/
│ ├── verify.sh ← 工具链合规检查(幂等只读,维护/retrofit 用
│ ├── install-skill.sh ← 整目录拷贝安装 skill 到 ~/.claude/skills/
│ ├── check-docs.sh ← 校验 README 覆盖 template 架构基座目录
│ └── retrofit.sh ← 补装工具链到已有项目
└── template/