God's eye view of your dev repos. Multi-project tracking across GitHub/Azure DevOps. AI learns from your commits to upgrade your agents.md.

# god-mode Skill

> 适用于 OpenClaw 的开发者监督与 AI 智能体指导。

## 概览

**god-mode** 让您对所有编码项目拥有全局视角，并指导您编写更好的 AI 智能体指令。

**核心特性：** - 多项目状态仪表板 - 来自 GitHub 的增量同步（即将支持 Azure/GitLab） - 基于提交模式的智能体指令分析 - 本地 SQLite 缓存以实现快速查询

## 快速开始

```bash # First-run setup god setup # Add a project god projects add github:myuser/myrepo # Sync data god sync # See overview god status # Analyze your agents.md god agents analyze myrepo ```

## 命令

### `god status [project]` 显示所有项目的概览，或单个项目的详细信息： ```bash god status # All projects god status myproject # One project in detail ```

### `god sync [project] [--force]` 从代码仓库获取/更新数据： ```bash god sync # Incremental sync all god sync myproject # Just one project god sync --force # Full refresh (ignore cache) ```

### `god projects` 管理已配置的项目： ```bash god projects # List all god projects add github:user/repo # Add project god projects remove myproject # Remove project ```

### `god agents analyze <project>` 根据提交历史分析 agents.md： ```bash god agents analyze myproject ```

找出您的智能体指令与实际工作模式之间的差距，并提出改进建议。

### `god agents generate <project>`（即将推出） 通过分析仓库结构为新项目初始化 agents.md。

## 配置

配置文件：`~/.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 ```

## 数据存储

所有数据均存储在本地 `~/.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 处理工具

## 示例

### 晨间检查 ```bash god status # See all projects at a glance # Notice any stale PRs or quiet projects ```

### 切换项目前 ```bash god status myproject # See recent activity, open PRs, issues # Remember where you left off ```

### 改进您的 AI 助手 ```bash god agents analyze myproject # Get suggestions based on your actual commit patterns # Apply recommendations to your agents.md ```

### 每周回顾 ```bash god status # Review activity across all projects # Identify projects needing attention ```

## 智能体工作流

### 每日简报（心跳） ```markdown # HEARTBEAT.md - Run `god status` and summarize: - Projects with stale PRs (>3 days) - Projects with no activity (>5 days) - Open PRs needing review ```

### 智能体分析（定时任务） ```yaml # Weekly agent instruction review schedule: "0 9 * * 1" # Monday 9am task: | Run `god agents analyze` on high-priority projects. If gaps found, notify with suggestions. ```

## 故障排查

### "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*