codeberg

核心用法

Codeberg Skill 是一个纯文档型的 Agent Skill，旨在帮助开发者通过 tea CLI 工具与 Codeberg（欧洲开源代码托管平台）进行交互。该技能本身不包含可执行代码，而是提供了一系列标准化的命令行示例，涵盖仓库管理的核心场景。

在功能层面，技能支持四大核心模块：首先是 Pull Requests 管理，包括列出开放 PR 和查看特定 PR 详情；其次是 Issues 追踪，支持列举和查看具体 Issue；第三是 Actions CI/CD，可查询仓库的 Secrets 和 Variables 配置；最后是 高级 API 查询，通过 tea api 命令结合 jq 工具实现自定义数据过滤。使用前需通过 tea login add 配置 Codeberg 访问令牌，建立安全连接。

显著优点

安全透明是该技能的首要优势。作为纯 Markdown 文档型资产，其不包含任何可执行脚本或动态代码加载，所有命令均为只读查询示例，用户可完全审计实际执行内容。其次，隐私合规性突出，Codeberg 作为欧洲非盈利开源平台，遵循 GDPR 规范，适合对数据主权敏感的团队。第三，轻量无侵入，技能仅依赖开源的 tea CLI 工具（Gitea/Codeberg 官方兼容客户端），无额外运行时依赖。最后，开源生态友好，与 Forgejo 实例完全兼容，支持欧洲开源社区的工作流。

潜在缺点或局限性

该技能的主要局限在于功能覆盖范围。目前提供的示例主要集中在数据查询（List/View），缺乏创建、修改或删除操作的示例，对于需要完整 CRUD 操作的自动化工作流支持有限。其次，前置配置依赖较重，用户必须自行安装 tea CLI 并手动配置访问令牌，对新手存在一定门槛。第三，平台特异性，虽然 Codeberg 基于 Forgejo，但技能针对 Codeberg 优化，迁移到其他 Gitea 实例可能需要调整 URL 配置。

适合的目标群体

本技能特别适合三类用户：欧洲开源项目贡献者和重视数据隐私的开发者，可利用 Codeberg 的 GDPR 合规优势；tea CLI 现有用户，希望快速查阅常用命令；以及自动化工作流构建者，需要将 Codeberg 仓库状态查询集成到 CI/CD 管道或报告生成脚本中的 DevOps 工程师。对于从 GitHub/GitLab 迁移到 Codeberg 的团队，该技能也提供了平滑的过渡参考。

使用风险与注意事项

尽管技能本身安全等级为 S 级，但令牌管理风险需用户自行承担。配置 tea login 时使用的 Personal Access Token 具有实际仓库访问权限，建议遵循最小权限原则，仅授予必要的读取权限，并定期轮换。其次，依赖项风险，tea CLI 作为外部二进制依赖，需通过 brew 或 go 安装，用户应确保从官方渠道获取。最后，误操作风险，虽然技能提供的是查询示例，但用户在实际执行命令时若误修改参数（如将 list 改为 delete），可能导致数据变更，建议在执行前仔细核对命令语义。