okr

okr

AI-powered OKR Creator — 给你的项目定方向，用 PUA 话术逼你执行

A PUA-like project — 基于 PUA skill 的理念和话术体系，专注于项目目标管理。PUA 让 AI 不敢摆烂，OKR 让 AI 知道往哪卷。

你连目标都没有，做什么项目？

一个 AI Agent skill，分析任何项目后自动生成定制化的 OKR（Objectives and Key Results）skill，并部署 GitHub Action 进行每日自动追踪。不限于代码项目——写作、研究、运营、产品、设计等任何项目都适用。支持 Claude Code、OpenAI Codex CLI、CodeBuddy。

The Problem: 项目没有方向感

模式	表现
无目标	想到什么做什么，做完不知道有没有价值
目标模糊	"提升质量"、"优化性能"——没有数字，没有验收标准
定了不追	OKR 写完放进抽屉，下个季度才想起来
各干各的	团队成员方向不一致，重复劳动
AI 没方向	AI 在 repo 中工作但不知道项目的优先级

安装

Claude Code

# 方式一：通过 marketplace 安装
claude plugin marketplace add chainreactors/okr-creator
claude plugin install okr-creator@okr

# 方式二：手动安装
git clone https://github.com/chainreactors/okr-creator.git ~/.claude/plugins/okr

OpenAI Codex CLI

mkdir -p ~/.codex/skills/okr-creator
curl -o ~/.codex/skills/okr-creator/SKILL.md \
  https://raw.githubusercontent.com/chainreactors/okr-creator/main/skills/okr-creator/SKILL.md

# /okr 命令
mkdir -p ~/.codex/prompts
curl -o ~/.codex/prompts/okr.md \
  https://raw.githubusercontent.com/chainreactors/okr-creator/main/commands/okr.md

CodeBuddy (Tencent)

# 方式一：通过 marketplace 安装
codebuddy plugin marketplace add chainreactors/okr-creator
codebuddy plugin install okr-creator@okr

# 方式二：手动安装
mkdir -p ~/.codebuddy/skills/okr-creator
curl -o ~/.codebuddy/skills/okr-creator/SKILL.md \
  https://raw.githubusercontent.com/chainreactors/okr-creator/main/skills/okr-creator/SKILL.md

使用

在任何项目中输入 /okr:create，skill 会自动完成全部流程：

Step	动作	说明
1	读项目身份证	README、配置、目录结构、git log、待办
2	六维诊断	愿景、质量、债务、架构、文档、自动化逐项评分
3	拷问用户意图	"这个项目你到底想做成什么样？优先级是什么？底线在哪？"
4	制定 OKR	3-5 个 O，每个 2-4 个 KR，每个 KR 带 Harness
5-6	生成 + 验证	写入 .claude/skills/okr/SKILL.md 并读回确认
7	部署 Action	写入 workflow + prompt + 创建 label + 输出配置引导
8	输出报告	六维评分 + OKR 摘要 + 最高优先级

Auto Mode（非交互式）

在 CI/CD 或批量场景中，可以跳过用户交互：

使用 /okr:create 并加上 --auto 参数，不要与人类确认，直接执行

AI 会基于诊断数据自主判断方向并生成 OKR，标注 [Auto-generated]。

How It Works

OKR Creator 不只是生成目标——它构建了一个完整的项目改进引擎：SKILL.md 定义方向和执行协议，PROGRESS.md 持久化进展记忆，GitHub Actions 每日深度评审并给出改进建议，可选的对齐检查让每次 PR 都与目标对齐。

┌────────────────────────────────────────────────┐
│              /okr:create 触发                       │
└──────────┬─────────────────────────────────────┘
           ▼
┌──────────────────┐     ┌──────────────────┐
│  Step 1-2        │     │  Step 3          │
│  读项目 → 六维诊断│────▶│  拷问用户意图     │
└──────────────────┘     └────────┬─────────┘
                                  ▼
┌──────────────────┐     ┌──────────────────────┐
│  Step 4          │     │  Step 5-6            │
│  制定 OKR        │────▶│  生成 SKILL.md       │
│  + KR 周分解     │     │  + PROGRESS.md 初始化 │
│  + 改进模式选择  │     │  写入 & 验证          │
└──────────────────┘     └────────┬────────────┘
                                  ▼
┌──────────────────────────────────────────────┐
│  Step 7: 部署 GitHub Action                   │
│                                               │
│  okr-review.yml  → 每日深度评审 + 自动 PR      │
│  okr-chat.yml    → @claude/@codex 对话续接     │
│  okr-review.md   → 评审 prompt（通用）         │
│  [可选] okr-align-check.yml → PR 对齐检查      │
└──────────────────────────────────────────────┘
           ▼
┌──────────────────────────────────────────────┐
│  改进引擎（持续运转）                          │
│                                               │
│  ┌ 每日 02:00 ──────────────────────────┐    │
│  │ 读 SKILL.md + PROGRESS.md            │    │
│  │ → 5 阶段深度评审（不只是进度追踪）     │    │
│  │ → 根因分析 + 跨 KR 依赖 + 行动队列   │    │
│  │ → Issue 评审 + 自动 PR 更新进展       │    │
│  └──────────────────────────────────────┘    │
│  ┌ 每次 PR（可选）─────────────────────┐     │
│  │ OKR 对齐检查 → PR comment           │     │
│  └──────────────────────────────────────┘    │
│  ┌ 日常开发 ────────────────────────────┐    │
│  │ SKILL.md 执行协议自动引导            │    │
│  │ → 对齐检查 → 优先级推荐 → 完成标注   │    │
│  └──────────────────────────────────────┘    │
└──────────────────────────────────────────────┘

核心能力