Project Onboarding
分析项目，把全局 skills 本地化到 .skills/。
流程
- 探索项目 — 用 Glob/Read 看目录结构、配置文件、代码样本
- 理解规范 — 从代码推断项目的测试、lint、commit 等规范
- 扫描全局 skills —
ls ~/.claude/skills/ - 对比分析 — 哪些 skill 需要适配？哪些直接可用？
- 交互确认 — 列出建议，让用户选择
- 生成 .skills/ — 写入本地化版本
排除列表（不参与本地化）
以下元 skills 默认跳过，除非用户明确要求：
project-onboard # 本 skill
skill-cleanup # 清理工具
skill-builder # 创建工具
skill-creator # 创建工具
skill-install # 安装工具
skill-sync # 同步工具
workflow-analyze # 分析工具
这些是管理 skills 的工具，不是项目工作流的一部分。
探索时重点看
配置文件: package.json, pyproject.toml, Makefile, tsconfig.json
CI/CD: .github/workflows/, .gitlab-ci.yml
规范: .eslintrc, .prettierrc, commitlint.config.js
测试: jest.config.js, pytest.ini, *_test.go
现有 Claude 配置: CLAUDE.md, .claude/
输出格式
.skills/
├── MANIFEST.json # 简单记录：哪些被本地化了
├── test/
│ └── SKILL.md # 适配后的 test skill
└── commit/
└── SKILL.md # 适配后的 commit skill
MANIFEST.json 示例
{
"project": "my-app",
"localized": ["test", "commit"],
"skipped": ["code"],
"created": "2024-01-12"
}
本地化适配示例
全局 skill 写的是 npm test，但项目用 jest:
## Pre-flight Checklist
- [ ] Run `jest --coverage`
- [ ] Ensure coverage > 80%
ephemeral 标记
如果是临时任务相关的 skill，在 SKILL.md 开头加注释:
<!-- ephemeral: pr_merged:#123 -->
这样 /skill-cleanup 知道什么时候可以清理。