rick-agent

模型分工

主 Pi（gpt-5.5 high）  →  调度 / 规划 / 严格 review
Subagent（Composer）    →  isolated worktree 实现 + commit + push + MR

本地路径：/Users/admin/Workspace/projects/rick-agent

快速接入

git clone git@github.com:swiftwind0405/rick-agent.git ~/Workspace/projects/rick-agent
cd ~/Workspace/projects/rick-agent
./scripts/bootstrap.sh

bootstrap 做什么：

1. 创建 ~/.pi/agent/、~/.config/rpiv-web-tools/
2. Symlink pi/settings.json、models.json、skills、agents、extensions
3. 拷贝 config.example.json → ~/.config/rpiv-web-tools/config.json（占位，非 symlink）

bootstrap 后手动完成：

配置结构

rick-agent/
├── .pi/                          # 项目级 Pi 配置（仅在本 repo 启动 Pi 时生效）
│   ├── settings.json             # pin pi-codex-search
│   └── pi-codex-search.json      # codex_search tool 默认参数
├── pi/                           # 全局 Pi 配置（symlink → ~/.pi/agent/）
│   ├── settings.json             # 主配置：模型、thinking、18 个 npm 包
│   ├── models.json               # 空 providers（不维护自定义 LLM）
│   ├── agents/                   # 4 个 custom agent
│   ├── extensions/project-workflow/  # 自写 extension + projectd daemon
│   └── skills/                   # 9 个自写 skill
├── rpiv-web-tools/config.example.json
├── docs/                         # workflow 详细文档
└── scripts/bootstrap.sh

全局配置 pi/settings.json

{
  "defaultProvider": "openai-codex",
  "defaultModel": "gpt-5.5",
  "defaultThinkingLevel": "high",
  "packages": [
    "npm:pi-cursor-sdk",
    "npm:@tintinweb/pi-subagents",
    "npm:@juicesharp/rpiv-*",
    "npm:pi-context-prune",
    "npm:@cnife/pi-simple-plannotator",
    ...
  ]
}

插件分组（18 包）

项目级配置 .pi/

只在 rick-agent 目录启动 Pi 时加载，不影响其它项目：

改配置怎么生效

thinking level 选择

临时拉高：/think high 或 /think xhigh。

自定义代理

工作流一：Project Workflow

把「issue 队列 → AI worker → review」的研发流程放进 Pi，不绑定具体项目或 tracker。通用 SOP 在 skills，确定性状态机在 extension。

状态机

GitLab issue closed = canonical done。不自动 merge，不手工打 status::done label。

架构分层

flowchart TD
  subgraph target["目标业务仓库"]
    config["docs/agents/project-workflow.md"]
    queue["Issue queue
triage → ready → running → review → done"]
    runtime[".pi-project-workflow/
workflow.sqlite"]
  end

  subgraph pi["Pi session"]
    execute["/project_issue_execute"]
    control["project-workflow extension"]
    worker["project-worker
cursor/composer-2.5"]
    mr["commit + push + MR/PR"]
  end

  human["人类验收"]

  config --> control
  queue --> execute
  execute --> control
  control -->|claim| queue
  control --> runtime
  control --> worker
  worker --> mr
  mr --> control
  control -->|pass: review| queue
  queue --> human
  human -->|merge + close| queue
        

Skills 入口

Extension Tools（14 个）

支持的 tracker adapter：command、vikunja-vja、github-gh、gitlab-glab、gitee-api。

硬规则

目标仓库配置模板

每个业务项目需 docs/agents/project-workflow.md，声明 tracker、状态映射、命令、验证方式。示例状态映射（GitLab/Gitee）：

工作流二：Hybrid Plan-Implement

本地 PR-like loop：主 Pi 规划 + review，Composer 在 isolated worktree 实现。

/skill:hybrid-plan-implement <要实现的需求>

输出 ready branches、merge 顺序、本地 merge 命令。不自动 merge。

适合：多文件、可拆分实现，希望 gpt-5.5 high 做架构判断。
不适合：单行小改、非 git repo、工作区 dirty 且不想先处理。

辅助 Skills

可选能力

安全约定

• 绝不 commit BRAVE_SEARCH_API_KEY / CURSOR_API_KEY
• key 走 1Password / macOS Keychain，bootstrap 后手动注入
• rpiv-web-tools/config.json 和 Discord config 均在 .gitignore
• 运行时状态 {repo}/.pi-project-workflow/ 也须加入目标仓库 .gitignore

仓库内文档