god-mode

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

god-mode Skill

god-mode Skill

Developer oversight and AI agent coaching for OpenClaw.
面向OpenClaw的开发者监督与AI Agent指导工具。

Overview

概述

god-mode gives you a bird's-eye view of all your coding projects and coaches you to write better AI agent instructions.
Key features:
  • Multi-project status dashboard
  • Incremental sync from GitHub (Azure/GitLab coming)
  • Agent instruction analysis based on commit patterns
  • Local SQLite cache for fast queries
god-mode 为你提供所有编码项目的全局视角,并指导你编写更优质的AI Agent指令。
核心功能:
  • 多项目状态仪表盘
  • 从GitHub增量同步(即将支持Azure/GitLab)
  • 基于提交模式的Agent指令分析
  • 本地SQLite缓存,实现快速查询

Quick Start

快速开始

bash
undefined
bash
undefined

First-run setup

首次运行设置

god setup
god setup

Add a project

添加项目

god projects add github:myuser/myrepo
god projects add github:myuser/myrepo

Sync data

同步数据

god sync
god sync

See overview

查看概览

god status
god status

Analyze your agents.md

分析你的agents.md文件

god agents analyze myrepo
undefined
god agents analyze myrepo
undefined

Commands

命令说明

god status [project]

god status [project]

Show overview of all projects, or details for one:
bash
god status              # All projects
god status myproject    # One project in detail
展示所有项目的概览,或单个项目的详细信息:
bash
god status              # 所有项目
god status myproject    # 单个项目详情

god sync [project] [--force]

god sync [project] [--force]

Fetch/update data from repositories:
bash
god sync                # Incremental sync all
god sync myproject      # Just one project
god sync --force        # Full refresh (ignore cache)
从代码仓库获取/更新数据:
bash
god sync                # 增量同步所有项目
god sync myproject      # 仅同步单个项目
god sync --force        # 全量刷新(忽略缓存)

god projects

god projects

Manage configured projects:
bash
god projects                        # List all
god projects add github:user/repo   # Add project
god projects remove myproject       # Remove project
管理已配置的项目:
bash
god projects                        # 列出所有项目
god projects add github:user/repo   # 添加项目
god projects remove myproject       # 删除项目

god agents analyze <project>

god agents analyze <project>

Analyze agents.md against commit history:
bash
god agents analyze myproject
Finds gaps between your agent instructions and actual work patterns, suggests improvements.
对比提交历史分析agents.md文件:
bash
god agents analyze myproject
查找你的Agent指令与实际工作模式之间的差距,并提出改进建议。

god agents generate <project>
(Coming Soon)

god agents generate <project>
(即将推出)

Bootstrap agents.md for a new project by analyzing repo structure.
通过分析仓库结构,为新项目快速生成agents.md文件。

Configuration

配置说明

Config file:
~/.config/god-mode/config.yaml
yaml
projects:
  - id: github:user/repo
    name: My Project      # Display name
    priority: high        # high/medium/low
    tags: [work, api]
    local: ~/code/myrepo  # Local clone path

sync:
  initialDays: 90         # First sync lookback
  commitsCacheMinutes: 60

analysis:
  agentFiles:             # Files to search for
    - agents.md
    - AGENTS.md
    - CLAUDE.md
    - .github/copilot-instructions.md
配置文件路径:
~/.config/god-mode/config.yaml
yaml
projects:
  - id: github:user/repo
    name: My Project      # 显示名称
    priority: high        # 高/中/低
    tags: [work, api]
    local: ~/code/myrepo  # 本地克隆路径

sync:
  initialDays: 90         # 首次同步回溯天数
  commitsCacheMinutes: 60

analysis:
  agentFiles:             # 需搜索的文件
    - agents.md
    - AGENTS.md
    - CLAUDE.md
    - .github/copilot-instructions.md

Data Storage

数据存储

All data stored locally in
~/.god-mode/
:
  • cache.db
    - SQLite database (commits, PRs, issues, analyses)
  • contexts/
    - Saved workspace contexts (v0.2)
所有数据本地存储于
~/.god-mode/
目录:
  • cache.db
    - SQLite数据库(存储提交记录、PR、问题、分析结果)
  • contexts/
    - 已保存的工作区上下文(v0.2版本)

Authentication

身份验证

god-mode uses your existing CLI authentication:
ProviderCLISetup
GitHub
gh
gh auth login
Azure
az
az login
GitLab
glab
glab auth login
No tokens stored by god-mode. We delegate to CLIs you already trust.
god-mode 使用你已有的CLI身份验证:
服务商CLI工具设置方法
GitHub
gh
gh auth login
Azure
az
az login
GitLab
glab
glab auth login
god-mode不会存储任何令牌,我们委托给你已信任的CLI工具处理。

Requirements

依赖要求

  • gh
    - GitHub CLI (for GitHub repos)
  • sqlite3
    - Database
  • jq
    - JSON processing
  • gh
    - GitHub CLI(用于GitHub仓库)
  • sqlite3
    - 数据库工具
  • jq
    - JSON处理工具

Examples

使用示例

Morning Check-In

晨间检查

bash
god status
bash
god status

See all projects at a glance

快速查看所有项目状态

Notice any stale PRs or quiet projects

发现任何停滞的PR或活跃度低的项目

undefined
undefined

Before Switching Projects

切换项目前

bash
god status myproject
bash
god status myproject

See recent activity, open PRs, issues

查看近期活动、待合并的PR、问题

Remember where you left off

回顾上次工作进度

undefined
undefined

Improving Your AI Assistant

优化你的AI助手

bash
god agents analyze myproject
bash
god agents analyze myproject

Get suggestions based on your actual commit patterns

根据实际提交模式获取改进建议

Apply recommendations to your agents.md

将建议应用到你的agents.md文件中

undefined
undefined

Weekly Review

每周回顾

bash
god status
bash
god status

Review activity across all projects

查看所有项目的活动情况

Identify projects needing attention

识别需要关注的项目

undefined
undefined

Agent Workflows

Agent工作流

Daily Briefing (Heartbeat)

每日简报(心跳检查)

markdown
undefined
markdown
undefined

HEARTBEAT.md

HEARTBEAT.md

  • Run
    god status
    and summarize:
    • Projects with stale PRs (>3 days)
    • Projects with no activity (>5 days)
    • Open PRs needing review
undefined
  • 运行
    god status
    并总结:
    • 停滞超过3天的PR项目
    • 超过5天无活动的项目
    • 需要评审的待合并PR
undefined

Agent Analysis (Cron)

Agent分析(定时任务)

yaml
undefined
yaml
undefined

Weekly agent instruction review

每周Agent指令评审

schedule: "0 9 * * 1" # Monday 9am task: | Run
god agents analyze
on high-priority projects. If gaps found, notify with suggestions.
undefined
schedule: "0 9 * * 1" # 每周一上午9点 task: | 对高优先级项目运行
god agents analyze
。 若发现差距,发送包含改进建议的通知。
undefined

Troubleshooting

故障排除

"gh: command not found"

"gh: command not found"

Install GitHub CLI: https://cli.github.com/
安装GitHub CLI:https://cli.github.com/

"Not logged in to GitHub"

"Not logged in to GitHub"

Run:
gh auth login
运行:
gh auth login

"No projects configured"

"No projects configured"

Add a project:
god projects add github:user/repo
添加项目:
god projects add github:user/repo

Stale data

数据过时

Force refresh:
god sync --force

OpenClaw Community Skill
License: MIT
Repository: https://github.com/InfantLab/god-mode-skill
强制刷新:
god sync --force

OpenClaw社区Skill
许可证:MIT
代码仓库:https://github.com/InfantLab/god-mode-skill