repo-maintenance

维护仓库的完整性与文档的准确性。无论是进行结构审核、验证配置的有效性，还是梳理库存信息，都可优先选用此功能。在主动验证仓库状态，或同步更新文档时，更是大有裨益。示例： - 用户：“验证仓库”→运行audit_repo.py。 - 用户：“检查代理”→运行audit_repo.py，查看潜在的错误与问题。 - 用户：“更新文档”→运行sync_docs.py。 - 用户：“排查问题”→进行全面的审计与检查。

SKILL.md

--- frontmatter

name: repo-maintenance
description: |-
  Maintain repository integrity and documentation. Use for auditing structure, checking config validity, and reviewing inventory. Use proactively to validate the repository or sync documentation.
  Examples:
  - user: "Validate the repo" → run audit_repo.py
  - user: "Check agents" → run audit_repo.py, review errors
  - user: "Update documentation" → run sync_docs.py
  - user: "Check for issues" → run full audit

Repository Maintenance Skill

This skill provides the tools to act as a Repo Custodian.

Validate Repository

Ensure configuration files (agents, commands, skills) are valid.

•Command: python3 .opencode/skill/repo-maintenance/scripts/audit_repo.py

Sync Documentation

Report on repository inventory and suggest whether docs need updating.

•Command: python3 .opencode/skill/repo-maintenance/scripts/sync_docs.py

</instructions> <workflow>

After a Failed Audit

When the audit reports errors or warnings:

•Read affected files - MUST read each file listed in the output
•Analyze issues - Understand what changes would fix each issue
•Ask the user - MUST use question tool to confirm which fixes to apply
•Apply selectively - Only fix what the user approves

MUST NOT auto-fix all issues. Mass changes can break working configurations.

</workflow> <reference>

Standards

Refer to references/validation-rules.md for:

•YAML Frontmatter Schema
•Description patterns (agents, commands, skills)
•RFC+XML compliance requirements
•Post-audit workflow details

</reference>