---
categories:
  - "[[LLM Wiki]]"
tags:
  - wiki
  - concept
  - skill
  - development
  - gitea
  - openclaw
created: 2026-04-07
source: "[[Gitea助手开发]]"
type: concept
aliases:
  - Gitea 助手 Skill
  - 自定义 Skill 开发
  - Skill 开发实践
---

# Gitea 助手开发

> **一句话描述**：通过开发 Gitea 仓库助手 Skill 探索自定义 Skill 的实现过程

## 项目背景

你已经有一个 Gitea 仓库同步脚本（`sync-gitea.bat`），这个实战项目将开发一个 Skill 来管理和操作这个仓库。

**目标**：开发一个 Gitea 仓库助手 Skill，可以：
- 查看仓库状态
- 列出最近提交
- 搜索文件内容

---

## Skill 开发探索

### 推荐探索方向

#### 方向 1：设计 Skill 功能

**思考问题**：
- 你希望这个 Skill 做什么？
- 用户会如何使用它？
- 哪些功能是核心的，哪些是次要的？

**实验思路**：
- 列出你想要的功能列表
- 优先级排序
- 设计用户交互流程

#### 方向 2：编写 SKILL.md

**实验思路**：
- 参考现有 Skill 结构的最佳实践
- 编写 Gitea 助手的 SKILL.md
- 定义元数据、指令和工具

**可能需要**：
- 描述 Skill 的用途
- 定义工具的参数和返回值
- 编写清晰的使用说明

#### 方向 3：实现工具逻辑

**实验思路**：
- 实现工具的调用逻辑
- 使用 `git` 命令与仓库交互
- 添加错误处理

**技术考虑**：
- 如何调用系统命令？
- 如何处理命令输出？
- 如何捕获和报告错误？

#### 方向 4：测试和迭代

**实验思路**：
- 测试各种使用场景
- 修复 bug
- 优化提示词
- 编写使用文档

**测试场景**：
- 查看仓库状态
- 列出最近提交
- 搜索文件内容
- 错误处理（无效路径等）

---

## 开发记录

### 初始阶段

在 `raw/Gitea助手开发.md` 中记录设计、开发过程、测试结果和困惑…

### 对话讨论

在开发过程中记录与 AI 的对话内容、讨论结果…

---

## 相关资源

- Skills 文档：https://docs.openclaw.ai/skills
- GitHub Git 文档：https://git-scm.com/doc
- 你的 Gitea 仓库

## 关键问题

**如何开发一个可复用的自定义 Skill？**

通过这个项目，探索以下问题：

1. Skill 的元数据应该如何定义？
2. 工具的参数和返回值如何设计？
3. 如何处理错误和异常情况？
4. 如何编写清晰的使用说明？
5. 如何测试和迭代 Skill？

---

## 从这里开始

**你对开发 Gitea 助手有什么想法？**

例如：

- "我想这个 Skill 能帮我查看最近的提交"
- "怎么开始写 SKILL.md？"
- "工具逻辑应该怎么实现？"
- "如何测试我的 Skill？"

随时开始，随时提问。