skills/mksteady/mkskills/project-onboard

project-onboard

SKILL.md

Project Onboarding

分析项目,把全局 skills 本地化到 .skills/

流程

  1. 探索项目 — 用 Glob/Read 看目录结构、配置文件、代码样本
  2. 理解规范 — 从代码推断项目的测试、lint、commit 等规范
  3. 扫描全局 skillsls ~/.claude/skills/
  4. 对比分析 — 哪些 skill 需要适配?哪些直接可用?
  5. 交互确认 — 列出建议,让用户选择
  6. 生成 .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 知道什么时候可以清理。

Weekly Installs
3
GitHub Stars
9
First Seen
Feb 27, 2026
Installed on
opencode3
gemini-cli3
claude-code3
github-copilot3
codex3
kimi-cli3