RepoStew Skills

RepoStew

**简体中文** | [English](README.en.md)

RepoStew 是一个可移植的 [Agent Skill](https://agentskills.io/)，用于负责任地维护 GitHub 仓库。它帮助编码智能体发现和评估 issue、审计仓库、实现聚焦修复、验证改动、提交 Pull Request，并持续处理审查意见和 CI。

RepoStew 与具体智能体和操作系统无关。核心工作流位于 `SKILL.md`，Python 脚本提供可选的确定性发现、状态跟踪和安全清理能力。Skill 不依赖特定模型供应商、GitHub 用户名、工作区路径或 shell。

RepoStew 能做什么

• 在确认 issue 仍可处理后修复指定 GitHub issue。
• 扫描单个仓库，寻找任意复杂度的高价值贡献候选。
• 在 GitHub 上发现合适的 issue，并机械检查重复项和认领状态。
• 全面审计仓库，起草有证据、非重复的 issue。
• 遵循目标仓库规则，创建最小且经过测试的改动。
• 在确认模式或自主模式下提交并跟踪 Pull Request。
• 持久保存未处理的 PR 评论和 review，继续完成代码修改、回复、CI 修复和冲突处理。
• 维护已验证具有 owner、admin 或 maintain 权限的仓库，不在每次事件中重复外部贡献者资格检查。
• 保存贡献记录，并跟进曾参与仓库中新开的 issue。
• 盘点并安全清理显式登记、且关联 PR 已合并或关闭的本地 worktree 和分支。
• 在当前对话中完成简单、局部的问题；在宿主支持时，将复杂或长期工作交接到单独的用户可见任务。
• 在真实使用暴露陈旧、不安全、损坏或不可移植的行为时维护 RepoStew 自身。

支持的智能体

RepoStew 遵循开放的 `SKILL.md` 格式。同一目录可用于实现 Agent Skills 标准的智能体。

智能体	项目级目录	用户级目录	调用方式
OpenAI Codex	.agents/skills/repostew	~/.agents/skills/repostew	提及 $repostew，或由 Codex 根据描述自动匹配
Cursor	.agents/skills/repostew 或 .cursor/skills/repostew	~/.agents/skills/repostew 或 ~/.cursor/skills/repostew	/repostew 或自动调用
Gemini CLI	.agents/skills/repostew 或 .gemini/skills/repostew	~/.agents/skills/repostew 或 ~/.gemini/skills/repostew	自动调用或使用 Gemini skills 命令
GitHub Copilot	.agents/skills/repostew 或 .github/skills/repostew	~/.agents/skills/repostew 或 ~/.copilot/skills/repostew	/repostew 或自动调用
Claude Code	.claude/skills/repostew	~/.claude/skills/repostew	/repostew 或自动调用

对于 Codex、Cursor、Gemini CLI 和 GitHub Copilot，推荐使用共享目录 `.agents/skills`。Claude Code 当前使用 `.claude/skills`。

平台文档：[Codex skills](https://learn.chatgpt.com/docs/build-skills)、[Claude Code skills](https://code.claude.com/docs/en/skills)、[Cursor skills](https://cursor.com/docs/skills)、[Gemini CLI skills](https://geminicli.com/docs/cli/skills/) 和 [GitHub Copilot skills](https://docs.github.com/en/copilot/concepts/agents/abo