hehaiguang1123
a6f05ab2d5
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
135 lines
2.7 KiB
Markdown
135 lines
2.7 KiB
Markdown
---
|
||
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？"
|
||
|
||
随时开始，随时提问。
|