名称： god-mode
描述： 开发者监督与 AI 智能体指导。适用于跨仓库查看项目状态、同步 GitHub 数据或根据提交模式分析 agents.md。
元数据： {"openclaw": {"requires": {"bins": ["gh", "sqlite3", "jq"]}}}
user-invocable: true

god-mode 技能

为 OpenClaw 提供开发者监督与 AI 智能体指导。

概述

god-mode 让你一览所有编码项目的全局，并指导你编写更优的 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、问题、分析结果）
- contexts/ - 保存的工作区上下文（v0.2 功能）

认证

god-mode 使用你现有的 CLI 认证：

god-mode 不存储任何令牌。 我们委托给你已经信任的 CLI 工具。

环境要求

• gh - GitHub CLI（用于 GitHub 仓库）
• sqlite3 - 数据库
• jq - JSON 处理工具

使用示例

每日晨间检查

god status
# 一览所有项目状态
# 留意任何停滞的 PR 或沉寂的项目

切换项目前

god status myproject
# 查看近期活动、开放的 PR 和问题
# 回忆上次的工作进度

改进你的 AI 助手

god agents analyze myproject
# 根据你实际的提交模式获取建议
# 将推荐方案应用到你的 agents.md 中

每周回顾

god status
# 回顾所有项目的活动情况
# 识别需要关注的项目

智能体工作流

每日简报（心跳）

# HEARTBEAT.md
- 运行 `god status` 并总结：
  - 有停滞 PR（>3 天）的项目
  - 无活动（>5 天）的项目
  - 需要评审的开放 PR

智能体分析（定时任务）

# 每周智能体指令审查
schedule: "0 9 * * 1"  # 每周一上午 9 点
task: |
  对高优先级项目运行 `god agents analyze`。
  如果发现差距，则通知并提供建议。

故障排除

"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