我自己算是弄架构的，所以很多事情就习惯了去分析设计模式和实现过程等等等。最近在教学生用 OpenCode 做开发，涉及到了技能（Skill）的内容，于是就顺路将自己的一些开发代码和撰写文档的习惯总结了一下，整理成了一套技能库，拿出来献丑，抛砖引玉，分享给大家。

简单说说是什么

OpenCode Skills 是一套为 OpenCode（开源 AI 编码工具）设计的技能集合，我这回自己弄的这个，包含 7 个专业技能和 6 个快捷命令。

项目地址：https://github.com/cycleuser/Skills

包含哪些技能

技能	用途
master-architect	系统架构设计
python-project-developer	Python 项目开发
software-planner	软件规划
iteration-manager	迭代测试改进
academic-writer	学术写作
coding-agent-patterns	AI 编码模式参考
skill-manager	技能管理（自动加载）

安装方法

方法一：在 OpenCode 中直接安装

如果你已经打开 OpenCode，最简单，直接在里面运行：

请帮我安装 https://github.com/cycleuser/Skills 这个技能库

OpenCode 会自动帮你完成安装，根本不用自己去做什么，就能安装成功了。

方法二：手动复制

# 克隆仓库
git clone https://github.com/cycleuser/Skills.git

# 复制到 OpenCode 目录
cp -r Skills/skills/* ~/.config/opencode/skills/
cp -r Skills/commands/* ~/.config/opencode/commands/

如果喜欢脚本安装，也可以用一键命令：

curl -sSL https://raw.githubusercontent.com/cycleuser/Skills/main/quick-install-opencode.sh | bash

验证安装

在 OpenCode 中输入：

/skills

看到技能列表就说明安装成功了。

如何使用

安装后，在 OpenCode 中可以直接使用以下命令：

/architect <任务描述>     # 架构设计
/python-dev <任务描述>    # Python 开发
/plan <任务描述>         # 项目规划
/iterate <任务描述>      # 迭代测试
/academic <任务描述>     # 学术写作
/skills                  # 列出所有技能

使用示例

架构设计：

/architect 设计一个博客系统，支持文章管理、用户评论和标签分类

会得到：需求分析、架构图、模块划分、任务分解等内容。

Python 开发：

/python-dev 创建一个 CSV 分析工具，支持 JSON 导出

会得到：项目结构、CLI 参数设计、API 模式、测试模板等内容。

项目规划：

/plan 规划一个任务管理系统

会得到：领域分析、架构设计、接口规划、文档结构等内容。

技能特点

1. 标准化的项目结构

Python 项目遵循统一的结构：

project/
├── package/
│   ├── __init__.py
│   ├── core.py
│   ├── cli.py
│   └── api.py
├── tests/
└── pyproject.toml

2. 统一的 CLI 参数

tool -V              # 版本
tool -v input.txt    # 详细输出
tool -o out.json     # 指定输出
tool --json          # JSON 格式
tool -q              # 安静模式

3. 一致的 API 返回

@dataclass
class ToolResult:
    success: bool
    data: Any = None
    error: str = None
    metadata: dict = {}

实际应用场景

场景一：新项目启动

/plan 规划项目
/architect 设计架构
/python-dev 开始开发
/iterate 测试改进

场景二：代码质量提升

/iterate 当前测试覆盖率 60%，提升到 90%

会自动执行：测试分析 → 覆盖率报告 → 改进建议 → 验证结果。

场景三：学术写作

/academic 撰写一篇关于机器学习的论文，目标会议 AAAI

会提供：论文结构、引用格式、写作规范等指导。

项目结构

Skills/
├── skills/              # 7 个技能
│   ├── master-architect/
│   ├── python-project-developer/
│   └── ...
├── commands/            # 6 个命令
└── docs/               # 文档

每个技能包含：

SKILL.md - 技能定义和说明
rules/ - 详细规则文档

适用人群

使用 OpenCode 进行开发的开发者
需要规范化项目结构的团队
希望提高代码质量的个人开发者
进行学术写作的研究人员

最后

这是一个实用的工具集，适合日常开发使用。欢迎试用和反馈。

如果觉得有用，欢迎 Star ⭐

预览时标签不可点

Name cleared

微信扫一扫赞赏作者

Like the AuthorOther Amount

赞赏后展示我的头像

作品

暂无作品

Like the Author

Other Amount

最低赞赏 ¥0

Back

Other Amount

赞赏金额