关于 repo-maintenance
repo-maintenance 是用于维护仓库的技能,可验证配置文件并检查文档是否反映仓库现状。审计发现问题后,需检查相关文件并先征求同意,再应用修复。
主要功能
- 01验证 Agent、命令和技能配置
- 02检查仓库文档清单
- 03参考验证规则
- 04修复前征求同意
适用场景
- 01变更后检查仓库配置
- 02评估文档是否需要更新
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ igorwarzocha/ opencode-workflows --skill repo-maintenance安装后在 Claude Code 中输入/repo-maintenance确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/maintenance-standards.mdvalidation-rules.mdscripts/audit_repo.pysync_docs.py详细介绍
仓库维护技能
此技能提供了充当仓库管理员所需的工具。
验证仓库
确保配置文件(Agent、命令、技能)有效。
- 命令:
python3 .opencode/skill/repo-maintenance/scripts/audit_repo.py
同步文档
报告仓库清单,并建议是否需要更新文档。
- 命令:
python3 .opencode/skill/repo-maintenance/scripts/sync_docs.py
审核失败后
当审核报告错误或警告时:
- 读取受影响的文件 - 必须读取输出中列出的每个文件
- 分析问题 - 了解需要进行哪些更改才能修复每个问题
- 询问用户 - 必须使用 question 工具确认要应用哪些修复
- 选择性应用 - 仅修复用户批准的内容
不得自动修复所有问题。大范围更改可能会破坏正常工作的配置。
标准
请参阅 references/validation-rules.md,了解:
- YAML Frontmatter 架构
- 描述模式(Agent、命令、技能)
- RFC+XML 合规性要求
- 审核后的工作流详情
评论
支持 Markdown