用途
god-mode 是一个面向 OpenClaw 的开发者监督与 AI 智能体指导技能。它提供所有编码项目的鸟瞰视图，并指导你编写更好的 AI 智能体指令。
主要能力
- 多项目状态仪表盘
- 从 GitHub 增量同步数据（Azure/GitLab 即将推出）
- 基于提交模式的智能体指令分析
- 本地 SQLite 缓存，实现快速查询
使用方式
快速开始
首次运行设置：
god setup
添加项目：
god projects add github:myuser/myrepo
同步数据：
god sync
查看总览：
god status
分析 agents.md：
god agents analyze myrepo
命令
god status [project]
显示所有项目的总览，或某个项目的详细信息：
god status # 所有项目
god status myproject # 单个项目详情
god sync [project] [--force]
从仓库获取/更新数据：
god sync # 增量同步所有
god sync myproject # 仅同步一个项目
god sync --force # 完全刷新（忽略缓存）
god projects
管理已配置的项目：
god projects # 列出所有
god projects add github:user/repo # 添加项目
god projects remove myproject # 移除项目
god agents analyze <project>
根据提交历史分析 agents.md：
god agents analyze myproject
找出智能体指令与实际工作模式之间的差距，并建议改进。
god agents generate <project>（即将推出）
通过分析仓库结构，为新项目引导生成 agents.md。
配置
配置文件：~/.config/god-mode/config.yaml
projects:
- id: github:user/repo
name: My Project # 显示名称
priority: high # high/medium/low
tags: [work, api]
local: ~/code/myrepo # 本地克隆路径
sync:
initialDays: 90 # 首次同步回溯天数
commitsCacheMinutes: 60
analysis:
agentFiles: # 要搜索的文件
- agents.md
- AGENTS.md
- CLAUDE.md
- .github/copilot-instructions.md
数据存储
所有数据存储在本地 ~/.god-mode/：
cache.db- SQLite 数据库（提交、PR、issue、分析）contexts/- 保存的工作区上下文（v0.2）
认证
god-mode 使用你现有的 CLI 认证：
| 提供商 | CLI | 设置 |
|---|---|---|
| GitHub | gh | gh auth login |
| Azure | az | az login |
| GitLab | glab | glab auth login |
god-mode 不存储令牌，而是委托给你已经信任的 CLI。
要求
gh- GitHub CLI（用于 GitHub 仓库）sqlite3- 数据库jq- JSON 处理
适用场景
示例
早晨检查
god status
# 一眼查看所有项目
# 注意任何过期的 PR 或安静的项目
切换项目前
god status myproject
# 查看最近活动、打开的 PR、issue
# 记住你上次停在哪里
改进你的 AI 助手
god agents analyze myproject
# 根据你实际的提交模式获取建议
# 将建议应用到你的 agents.md
每周回顾
god status
# 回顾所有项目的活动
# 识别需要关注的项目
智能体工作流
每日简报（心跳）
# HEARTBEAT.md
- 运行 `god status` 并总结：
- 有过期 PR（>3 天）的项目
- 无活动（>5 天）的项目
- 需要审查的打开的 PR
智能体分析（Cron）
# 每周智能体指令审查
schedule: "0 9 * * 1" # 周一上午 9 点
task: |
对高优先级项目运行 `god agents analyze`。
如果发现差距，通知并给出建议。
限制
- 目前仅支持 GitHub 同步，Azure/GitLab 标记为即将推出。
god agents generate命令标记为即将推出。- 需要预先安装
gh、sqlite3、jq。 - 需要已有的 CLI 认证（如
gh auth login）。
故障排除
"gh: command not found" 安装 GitHub CLI：https://cli.github.com/
"Not logged in to GitHub"
运行：gh auth login
"No projects configured"
添加项目：god projects add github:user/repo
数据过期
强制刷新：god sync --force
其他信息
OpenClaw 社区技能
许可证：MIT
仓库：https://github.com/InfantLab/god-mode-skill