agent-primer

April 30, 2026 · View on GitHub

English | 简体中文

一个轻量的 AI agent starter kit：少量高质量 Skill、MCP、以及 AGENTS.md / CLAUDE.md 行为准则。

它可以独立复制使用，也可以作为 Plexus team config 引入，让团队成员把同一套基线同步到 Claude Code、Codex、Cursor、Gemini CLI、Qwen Code、Factory Droid 等 agent。

默认推荐

首发只启用这些 Skill：

  • using-superpowers：每次任务开始时先检查并使用合适 Skill。
  • find-skills：需要新能力时先找现成 Skill，避免重复造轮子。
  • skill-creator：把反复出现的流程沉淀成标准 SKILL.md。
  • verification-loop：改完以后跑构建、类型、测试、格式等验证。
  • code-review：按 bug、回归、测试缺口优先做代码审查。
  • security-review：处理认证、输入、权限、密钥、MCP 配置时使用。
  • mcp-selection：新增或审查 MCP server 时使用。

默认同步这些无个人密钥/路径依赖的 MCP：

  • context7：实时库文档和代码示例。
  • openaiDeveloperDocs：OpenAI 官方开发文档。
  • playwright：浏览器自动化、前端验证、截图。

filesystem 和 github 也保留在 mcp/servers.yaml 里，但默认 enabledAgents: []。这两个需要个人本机路径或 token，应该由使用者在 Plexus 里按需启用并覆盖成本机配置。

这套首发刻意控制在 7 个 Skill + 3 个默认 MCP + 2 个可选 MCP 模板。更多领域型能力放在 market-scan.md 和 mcp/recommended-servers.md 的 optional 里，等真实需求出现再加。

此外，仓库根目录提供两个 agent instruction 文件：

  • CLAUDE.md：Claude Code 项目级行为准则。
  • AGENTS.md：Codex/通用 agent 项目级行为准则。

它们来自 Karpathy-inspired coding agent guidelines 的思路，属于基础行为约束，不计入 Skill 数量。

规则文件怎么选

  • 不用 Plexus：直接使用根目录的 AGENTS.md 或 CLAUDE.md。
  • 使用 Plexus：Plexus 会读取 rules/global.md，再同步到各 agent 的 instruction file。
  • rules/global.md 不是 AGENTS.md / CLAUDE.md 的替代品，它只是 Plexus team config 的入口格式。

Quick Start

Option A: Use with Plexus

Plexus 可以把这个 repo 当 team config 拉到 ~/.config/plexus/team/，再合并用户本机 personal layer 并同步到各 agent。

npx @plexus/cli join https://github.com/miniLV/agent-primer.git
npx @plexus/cli sync

也可以在 Plexus Dashboard 的 Team 页面点击 使用 agent-primer，再点击 加入。如果这个 repo 是 private，确保本机 GitHub credential 可用，或者用 SSH URL：git@github.com:miniLV/agent-primer.git。

后续更新：

npx @plexus/cli pull
npx @plexus/cli sync

Plexus 会读取：

  • rules/global.md：Plexus team config 的共享行为准则。
  • skills/<id>/SKILL.md：团队共享 Skill。
  • mcp/servers.yaml：团队批准的 MCP server。

也就是说，agent-primer 是“配置内容仓库”，Plexus 是“把这份配置应用到各个 agent 的本地控制台”：

agent-primer
  rules/global.md
  skills/*/SKILL.md
  mcp/servers.yaml
        │
        ▼
Plexus ~/.config/plexus/team/
        │
        ▼
Claude Code / Cursor / Codex / Gemini CLI / Qwen Code / Factory Droid

典型团队用法：

  1. 团队 fork 或直接订阅这个 repo。
  2. 成员在 Plexus Team 页填入 https://github.com/miniLV/agent-primer.git。
  3. Plexus 把默认 7 个 Skill 和 3 个安全 MCP 同步到本机 agent。
  4. filesystem / github 这类带个人路径或 token 的 MCP 保留为 placeholder，个人在 Plexus 里按需启用并覆盖。
  5. 团队后续通过 PR 改这个 repo，成员运行 plexus pull && plexus sync 接收更新。

Option B: Use Manually

不用 Plexus 时，可以按需复制：

cp AGENTS.md ~/.codex/AGENTS.md
cp -R skills/* ~/.codex/skills/

Claude Code 用户可以改用：

cp CLAUDE.md ~/.claude/CLAUDE.md
cp -R skills/* ~/.claude/skills/

MCP 配置按客户端选择：

把 token、数据库连接串、真实本地路径只放在个人本机配置里，不要提交到这个 repo。

目录

rules/global.md         # Plexus shared instruction baseline
skills/                 # 可复制的 SKILL.md 模板
mcp/                    # MCP 推荐清单和客户端示例配置
CLAUDE.md               # Claude Code instruction template
AGENTS.md               # Codex / generic agent instruction template
README.en.md            # English README
market-scan.md          # 2026-04-30 调研记录与来源