@cjhdev/repo-ai-governor

v0.1.5

Published

14 days ago

Repository-local AI governance CLI.

0High
0Medium
0Low

jimmydaddy

Repo AI Governor

English | 简体中文

Repo AI Governor 是一个仓库内 AI 治理 CLI，帮助团队让 AI 编码过程始终遵循统一流程和质量规则。

解决什么问题

强制先方案后编码（plan -> implement -> check -> review）。
让 sprint 产物保持一致（plan.md、checklist、CSV 台账、任务卡、CR 文件）。
通过规范包与 slot 注入项目特有规则。
在 Codex、GitHub Copilot、Claude Code 之间复用同一套治理能力。

安装

需要 Node.js >=18。

# 直接运行
npx @cjhdev/repo-ai-governor --help

# 或安装为开发依赖
npm install --save-dev @cjhdev/repo-ai-governor
npx repo-ai-governor --help

包名和命令名不同：

包名：@cjhdev/repo-ai-governor
命令名：repo-ai-governor

快速开始

TMP_DIR="$(mktemp -d /tmp/repo-ai-governor-demo.XXXXXX)"
CLI="npx @cjhdev/repo-ai-governor"

# 1) 初始化治理目录
$CLI init \
  --cwd "$TMP_DIR" \
  --project demo \
  --sprint sprint-001 \
  --adapter codex \
  --locale zh-CN

# 2) 按当前 AI 工具安装官方 skills
$CLI skills install \
  --cwd "$TMP_DIR" \
  --surface codex

# 3) 做一次基线校验
$CLI doctor \
  --cwd "$TMP_DIR" \
  --project demo \
  --sprint sprint-001 \
  --strict

# 4) 准备需求并生成计划
cat > "$TMP_DIR/request.md" <<'EOF'
# Requirement
Build a repository governance demo flow.
EOF

$CLI plan \
  --cwd "$TMP_DIR" \
  --project demo \
  --sprint sprint-001 \
  --input "$TMP_DIR/request.md" \
  --title "Repository governance demo flow"

会生成的核心产物：

.repo-ai-governor/governor.yaml
AGENTS.md
.repo-ai-governor/context/current-context.md
docs/<project>/<sprint>/plan.md
docs/<project>/<sprint>/tasks/*
docs/<project>/<sprint>/code-review/*

与 AI 工具结合

按工具类型安装 skills：

codex -> .codex/skills/
github-copilot -> .github/skills/
claude-code -> .claude/skills/

安装后建议让 AI 助手先做两件事：

读取 AGENTS.md 与 .repo-ai-governor/context/current-context.md
按已安装 skill 执行（例如 $governor-plan-runner、$governor-task-implementer、$governor-delivery-finisher）

核心命令

init：初始化治理配置与 sprint 结构。
skills：列出、安装、校验官方 skills。
doctor：校验环境、配置和目录结构。
plan：根据需求生成计划与任务产物。
check：执行治理检查。
review：生成 code review 记录。
review-verify：复核并推进 CR 状态流转。
report：输出 summary/markdown/json 报告。
upgrade：安全升级生成式配置与模板。

自定义规范与项目规则

governor.yaml 支持规范覆盖和 slot 配置：

standards:
  preset: official/base
  overrides:
    quality:
      tests: required
slots:
  enabled:
    - security-review

项目自定义 slot 文件路径：.repo-ai-governor/slots/*.yaml。

如果你的团队已经有 code_standards.md，可以在文档里加入 ## Verification Commands 段落，把它变成可执行门禁：

npm run check:code-standards

当前仓库里 npm run check 已经接到了这个 standards 门禁。

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme