project-onboard

📁 mksteady/mkskills 📅 Today
2
总安装量
1
周安装量
#74921
全站排名
安装命令
npx skills add https://github.com/mksteady/mkskills --skill project-onboard

Agent 安装分布

amp 1
cline 1
opencode 1
cursor 1
kimi-cli 1
codex 1

Skill 文档

Project Onboarding

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

流程

  1. 探索项目 — 用 Glob/Read 看目录结构、配置文件、代码样本
  2. 理解规范 — 从代码推断项目的测试、lint、commit 等规范
  3. 扫描全局 skills — ls ~/.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 知道什么时候可以清理。