用途
god-mode 是 OpenClaw 的社区技能,定位为开发者监督与 AI 智能体指导工具。它帮助开发者以鸟瞰视角查看所有编码项目,并指导编写更好的 AI 智能体指令。
主要能力
- 多项目状态仪表盘:通过
god status查看所有项目概览,或通过god status myproject查看单个项目详情。 - 增量同步 GitHub 数据:使用
god sync从仓库获取或更新数据,支持全量刷新(--force)。Azure 和 GitLab 同步标注为即将推出。 - 项目管理:使用
god projects列出、添加(如god projects add github:user/repo)或移除项目。 - 智能体指令分析:
god agents analyze <project>将 agents.md 与提交历史对比,找出指令与实际工作模式之间的差距并建议改进。 - 本地缓存:数据存储于
~/.god-mode/下的 SQLite 数据库(cache.db),用于快速查询。 - 配置灵活:配置文件为
~/.config/god-mode/config.yaml,可设置项目显示名、优先级、标签、本地克隆路径、首次同步回溯天数、提交缓存分钟数以及要搜索的智能体指令文件名(agents.md、AGENTS.md、CLAUDE.md、.github/copilot-instructions.md)。
使用方式
首次运行需执行 god setup 完成初始化。常用命令包括:
god projects add github:myuser/myrepo添加项目god sync同步数据god status查看概览god agents analyze myrepo分析智能体指令
认证复用现有 CLI:GitHub 用 gh auth login,Azure 用 az login,GitLab 用 glab auth login,god-mode 本身不存储令牌。
适用场景
- 每日晨间检查:运行
god status快速了解所有项目状态,发现停滞的 PR 或安静的项目。 - 切换项目前回顾:查看单个项目近期活动、未关闭 PR 和议题。
- 改进 AI 助手:基于实际提交模式获取 agents.md 改进建议。
- 每周回顾:审视所有项目活动,识别需要关注的项目。
- 智能体工作流:可结合心跳任务定期运行
god status汇总,或用 cron 每周运行god agents analyze。
限制与要求
需预先安装 gh(GitHub CLI)、sqlite3 和 jq。god agents generate 功能标注为即将推出。Azure/GitLab 同步尚未提供。所有数据仅存储在本地。