---
name: gitlink-snippet
version: 1.0.0
description: "代码片段管理：在仓库的 snippets/ 目录下管理代码片段，支持列出、查看、创建、删除。当用户需要管理或共享代码片段时触发。"
metadata:
  requires:
    bins: ["gitlink-cli"]
  cliHelp: "gitlink-cli snippet --help"
---

# gitlink-snippet（代码片段管理）

**CRITICAL — 开始前必须先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md)，其中包含认证、权限处理和 API 注意事项。**
**CRITICAL — 所有 Shortcuts 在执行写入/删除操作前，务必先确认用户意图。**
**CRITICAL — GitLink 操作只能用 `gitlink-cli`。禁止用 `gh`（GitHub CLI）操作 GitLink 资源。`gh` 仅适用于 GitHub 平台。**

> **前置条件：** 先阅读 [`../gitlink-shared/SKILL.md`](../gitlink-shared/SKILL.md) 了解认证和全局参数。

## 说明

代码片段存放在项目仓库的 `snippets/` 目录下，每个片段是一个独立的文件。
读操作（list/view）通过 Git 克隆实现，无需认证；写操作（create/delete）通过文件 REST API 实现，需要 Token。

## Shortcuts

| Shortcut | 说明 | 需要认证 |
|----------|------|----------|
| `snippet +list` | 列出代码片段 | 否（公开项目） |
| `snippet +view` | 查看代码片段内容 | 否（公开项目） |
| `snippet +create` | 创建代码片段 | 是 |
| `snippet +delete` | 删除代码片段 | 是 |

## 使用示例

```bash
# 列出代码片段
gitlink-cli snippet +list --owner myuser --repo myrepo

# 查看代码片段
gitlink-cli snippet +view --owner myuser --repo myrepo --name "hello.py"

# 创建代码片段（需要认证）
gitlink-cli snippet +create --owner myuser --repo myrepo --name "hello.py" --content 'print("Hello World!")' --language python --message "添加Python示例"

# 删除代码片段（确认后再执行）
gitlink-cli snippet +delete --owner myuser --repo myrepo --name "old.py"
```

## 注意事项

- 片段名带扩展名（如 `.py`、`.go`）会按原样存储；不带扩展名会自动追加 `.md`。
- `--language` 参数用于代码块语法高亮，不影响文件名。
- 执行写入/删除前务必确认用户意图。

## 相关链接

- [gitlink-repo](../gitlink-repo/SKILL.md) — 仓库管理
