# Jwang-Skills

**Repository Path**: kjfb/jwang-skills

## Basic Information

- **Project Name**: Jwang-Skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-15
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CodeBuddy Skills —— 个人技能库

集中管理 [CodeBuddy](https://www.codebuddy.ai) 的用户级 skill，通过 Gitee 私有仓库在
多台机器（Linux 服务器 / Windows 工作站）间同步。

远程仓库：`https://gitee.com/kjfb/jwang-skills.git`

---

## 1. 目录结构

```
~/.codebuddy/skills/            # Windows: %USERPROFILE%\.codebuddy\skills\
├── README.md                   # 本文件
└── embedded-docker-env/        # 用 Docker 封装嵌入式开发环境的完整工作流
    ├── SKILL.md                # skill 主文件（工作流，CodeBuddy 触发时加载）
    ├── references/
    │   └── pitfalls.md         # 实战踩坑清单（宿主机安装/构建/运行/分发 四类）
    └── assets/                 # 脚手架模板（占位符待替换后复制到项目中使用）
        ├── Dockerfile.template
        ├── build.sh.template
        ├── run.sh.template
        ├── export.sh.template
        └── dockerignore.template
```

## 2. 收录清单

| Skill | 用途 | 触发场景 |
|---|---|---|
| `embedded-docker-env` | 把 PetaLinux/Vivado/Vitis/Yocto/交叉工具链等嵌入式环境封装成 Docker 镜像并分发 | "docker 封装开发环境"、"制作环境镜像"、"容器化工具链"、"环境镜像交付" 等 |

## 3. Skill 的作用机制

- **存储位置**：用户级 `~/.codebuddy/skills/`（登录用户全局可用，与具体项目无关）。
- **触发**：CodeBuddy 根据每个 skill 的 `SKILL.md` 里的 `name`/`description` 自动判断
  何时加载，无需手动调用。
- **三层加载**：元数据（常驻）→ `SKILL.md` 正文（触发时）→ `references/`、`assets/`
  （按需），对上下文友好。

## 4. 新机器安装

```bash
# Linux / macOS
git clone https://gitee.com/kjfb/jwang-skills.git ~/.codebuddy/skills

# Windows PowerShell
git clone https://gitee.com/kjfb/jwang-skills.git $env:USERPROFILE\.codebuddy\skills
```

克隆后重启 CodeBuddy 会话即可生效。若目标目录已有同名 skill，先删除旧目录再克隆。

## 5. 日常同步

```bash
# 改动后提交推送
git add -A && git commit -m "说明" && git push

# 另一台机器获取最新
git pull
```

免输密码（可选）：`git config credential.helper store`，下次输入一次后记住。

## 6. 新增 / 修改 Skill

1. 新建目录 `<skill-name>/`，必须包含 `SKILL.md`（YAML frontmatter 的 `name` 与
   `description` 决定触发时机，描述务必写清 **WHEN to use**）。
2. 按需添加 `references/`（参考文档）、`assets/`（模板/脚本），不要放无关文件。
3. 命名规则：小写字母 + 数字 + 连字符，≤40 字符，目录名与 `name` 一致。
4. 提交推送，其他机器 `git pull`。

> 借助 CodeBuddy 的 skill-creator skill 可以快速生成规范骨架。

## 7. 注意事项

- `*.zip`（打包产物）已被 `.gitignore` 排除，只入库源文件。
- skill 目录内的文件会被 CodeBuddy 加载，**不要**存放敏感信息（密码、令牌）。
- 私有仓库，请勿改为公开。