god-mode
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinesegod-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
undefinedbash
undefinedFirst-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
undefinedgod agents analyze myrepo
undefinedCommands
命令说明
god status [project]
god status [project]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]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 projectsgod projects
god projectsManage 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>god agents analyze <project>
god agents analyze <project>Analyze agents.md against commit history:
bash
god agents analyze myprojectFinds 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>god agents generate <project>
(即将推出)
god agents generate <project>Bootstrap agents.md for a new project by analyzing repo structure.
通过分析仓库结构,为新项目快速生成agents.md文件。
Configuration
配置说明
Config file:
~/.config/god-mode/config.yamlyaml
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.yamlyaml
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.mdData Storage
数据存储
All data stored locally in :
~/.god-mode/- - SQLite database (commits, PRs, issues, analyses)
cache.db - - Saved workspace contexts (v0.2)
contexts/
所有数据本地存储于目录:
~/.god-mode/- - SQLite数据库(存储提交记录、PR、问题、分析结果)
cache.db - - 已保存的工作区上下文(v0.2版本)
contexts/
Authentication
身份验证
god-mode uses your existing CLI authentication:
| Provider | CLI | Setup |
|---|---|---|
| GitHub | | |
| Azure | | |
| GitLab | | |
No tokens stored by god-mode. We delegate to CLIs you already trust.
god-mode 使用你已有的CLI身份验证:
| 服务商 | CLI工具 | 设置方法 |
|---|---|---|
| GitHub | | |
| Azure | | |
| GitLab | | |
god-mode不会存储任何令牌,我们委托给你已信任的CLI工具处理。
Requirements
依赖要求
- - GitHub CLI (for GitHub repos)
gh - - Database
sqlite3 - - JSON processing
jq
- - GitHub CLI(用于GitHub仓库)
gh - - 数据库工具
sqlite3 - - JSON处理工具
jq
Examples
使用示例
Morning Check-In
晨间检查
bash
god statusbash
god statusSee all projects at a glance
快速查看所有项目状态
Notice any stale PRs or quiet projects
发现任何停滞的PR或活跃度低的项目
undefinedundefinedBefore Switching Projects
切换项目前
bash
god status myprojectbash
god status myprojectSee recent activity, open PRs, issues
查看近期活动、待合并的PR、问题
Remember where you left off
回顾上次工作进度
undefinedundefinedImproving Your AI Assistant
优化你的AI助手
bash
god agents analyze myprojectbash
god agents analyze myprojectGet suggestions based on your actual commit patterns
根据实际提交模式获取改进建议
Apply recommendations to your agents.md
将建议应用到你的agents.md文件中
undefinedundefinedWeekly Review
每周回顾
bash
god statusbash
god statusReview activity across all projects
查看所有项目的活动情况
Identify projects needing attention
识别需要关注的项目
undefinedundefinedAgent Workflows
Agent工作流
Daily Briefing (Heartbeat)
每日简报(心跳检查)
markdown
undefinedmarkdown
undefinedHEARTBEAT.md
HEARTBEAT.md
- Run and summarize:
god status- Projects with stale PRs (>3 days)
- Projects with no activity (>5 days)
- Open PRs needing review
undefined- 运行并总结:
god status- 停滞超过3天的PR项目
- 超过5天无活动的项目
- 需要评审的待合并PR
undefinedAgent Analysis (Cron)
Agent分析(定时任务)
yaml
undefinedyaml
undefinedWeekly agent instruction review
每周Agent指令评审
schedule: "0 9 * * 1" # Monday 9am
task: |
Run on high-priority projects.
If gaps found, notify with suggestions.
god agents analyzeundefinedschedule: "0 9 * * 1" # 每周一上午9点
task: |
对高优先级项目运行。
若发现差距,发送包含改进建议的通知。
god agents analyzeundefinedTroubleshooting
故障排除
"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/repoStale data
数据过时
Force refresh:
god sync --force