4d653c13a0
- 新增 cursor.md：Cursor 安装、注册、订阅说明 - 新增 claude-code.md：Claude Code 安装、注册、订阅及国内充值方案 - 新增 google-account.md：谷歌账号注册指南（含科学上网说明） - 更新 README：入门指南移至顶部，补充 Skills/Agent/MCP 概念说明 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
105 lines
3.5 KiB
Markdown
105 lines
3.5 KiB
Markdown
# ieslab 自建技能仓库
|
||
|
||
ieslab 团队的 Claude Code 自定义 Skills 集合，以插件形式统一管理和分发。
|
||
|
||
## AI 编程工具入门指南
|
||
|
||
刚接触 AI 编程工具？从这里开始：
|
||
|
||
| 文档 | 内容 |
|
||
|------|------|
|
||
| [google-account.md](./google-account.md) | 注册谷歌账号（推荐用于登录各 AI 工具） |
|
||
| [cursor.md](./cursor.md) | Cursor —— AI 代码编辑器，下载安装、注册、模型配置 |
|
||
| [claude-code.md](./claude-code.md) | Claude Code —— 终端 AI 编程助手，安装、注册、基本使用 |
|
||
|
||
初次使用 Claude Code，可以先了解这几个核心概念：
|
||
|
||
| 概念 | 一句话理解 | 官方文档 |
|
||
|------|-----------|---------|
|
||
| **Skills（技能）** | 给 Claude 预设的指令模板，用 `/` 调用，本仓库就是在扩展这个 | [查看文档](https://docs.anthropic.com/en/docs/claude-code/skills) |
|
||
| **Agent（代理）** | 让 Claude 自主拆解任务、调用工具、多步骤执行，像一个能自己干活的助手 | [查看文档](https://code.claude.com/docs/en/sub-agents) |
|
||
| **MCP** | 给 Claude 接上外部工具（数据库、浏览器、API 等）的标准插件协议 | [查看文档](https://code.claude.com/docs/en/mcp) |
|
||
|
||
---
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
ieslab_skills/
|
||
├── README.md
|
||
└── skills/ # 技能定义目录
|
||
└── <skill-name>/ # 每个技能独立子目录
|
||
├── SKILL.md # 技能主文件（必需）
|
||
└── ... # 可选辅助文件（脚本、模板、参考文档等）
|
||
```
|
||
|
||
## 安装
|
||
|
||
将需要的技能文件夹复制到 `.claude/skills/` 下即可：
|
||
|
||
```bash
|
||
# 仅当前项目可用
|
||
cp -r skills/<skill-name> /path/to/your-project/.claude/skills/
|
||
|
||
# 所有项目可用
|
||
cp -r skills/<skill-name> ~/.claude/skills/
|
||
```
|
||
|
||
安装后在 Claude Code 中输入 `/` 即可在补全列表中看到对应技能。
|
||
|
||
## 添加新技能
|
||
|
||
每个技能存放在 `skills/<技能名>/` 目录下，至少包含一个 `SKILL.md` 文件。
|
||
|
||
### SKILL.md 格式
|
||
|
||
```yaml
|
||
---
|
||
name: skill-name # 技能名，默认取目录名
|
||
description: 技能描述 # 建议填写，Claude 会根据此字段自动判断是否加载
|
||
argument-hint: "[参数]" # 可选，调用时显示的参数提示
|
||
---
|
||
|
||
技能的详细指令内容...
|
||
```
|
||
|
||
### 常用可选字段
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| `disable-model-invocation: true` | 禁止 Claude 自动调用，仅允许手动 `/` 调用 |
|
||
| `user-invocable: false` | 仅允许 Claude 自动调用，不在 `/` 菜单中显示 |
|
||
| `allowed-tools: Read, Grep` | 限制此技能可使用的工具 |
|
||
| `model: claude-opus-4-6` | 指定运行此技能的模型 |
|
||
| `context: fork` | 在子 Agent 中独立运行 |
|
||
|
||
### 目录规范
|
||
|
||
```
|
||
skills/my-skill/
|
||
├── SKILL.md # 主指令文件，建议保持 500 行以内
|
||
├── reference.md # 可选，详细参考文档
|
||
├── template.md # 可选，输出模板
|
||
└── scripts/
|
||
└── helper.py # 可选，辅助脚本
|
||
```
|
||
|
||
### 调用方式
|
||
|
||
- **手动调用**：在对话中输入 `/skill-name [参数]`
|
||
- **自动调用**：Claude 根据 `description` 字段判断场景后自动加载（默认行为）
|
||
|
||
## 技能列表
|
||
|
||
| 技能名 | 调用方式 | 描述 |
|
||
|--------|----------|------|
|
||
| [weekly-report](./skills/weekly-report/) | `/weekly-report` | 统计过去7天的 commit 和 PR，生成协作者个人周报与项目整体报告，通过 SMTP 发送邮件 |
|
||
|
||
## 更新技能
|
||
|
||
```bash
|
||
git pull
|
||
```
|
||
|
||
插件内容更新后，重启 Claude Code 会话即可生效。
|