diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json index f08fc4b1d..ae560d0ca 100644 --- a/.agents/plugins/marketplace.json +++ b/.agents/plugins/marketplace.json @@ -327,6 +327,18 @@ "authentication": "ON_INSTALL" }, "category": "MCP" + }, + { + "name": "caveman", + "source": { + "source": "local", + "path": "./plugins/codex/plugins/caveman" + }, + "policy": { + "installation": "AVAILABLE", + "authentication": "ON_INSTALL" + }, + "category": "开发工具" } ] } diff --git a/README.md b/README.md index cb1c563e6..ffe4f2c6d 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,8 @@ codex plugin add @eapil-skill-market 使用 `codex plugin list --marketplace eapil-skill-market` 输出里的精确 `plugin-id`。不要猜测中文名、翻译名或 display name。 +安装公共 skill 或第三方 Codex plugin 时也使用同一套命令；具体可安装项以 `codex plugin list --marketplace eapil-skill-market` 的实时输出为准。 + 如果插件刚安装到当前 Codex 会话中，启动新的 Codex thread 或新的 Codex 调用后再依赖新增 skills/hooks/MCP/app 配置。 卸载插件： diff --git a/config/external-sources.json b/config/external-sources.json index 9d1170882..6a90cf783 100644 --- a/config/external-sources.json +++ b/config/external-sources.json @@ -129,6 +129,54 @@ "LICENSE" ] }, + { + "id": "caveman", + "repo": "https://github.com/JuliusBrussee/caveman.git", + "ref": "main", + "adapter": "codex-plugin", + "pluginName": "caveman", + "category": "开发工具", + "sourcePath": "plugins/caveman", + "sparseCheckout": [ + "plugins/caveman" + ], + "include": [ + ".codex-plugin", + "skills", + "assets", + "agents" + ], + "excludePaths": [ + "skills/caveman-stats", + "skills/caveman-compress" + ], + "manifestOverrides": { + "description": "Caveman 是面向 Codex 的极简输出风格和压缩式协作 skill 集合。", + "interface": { + "displayName": "Caveman", + "shortDescription": "让 Codex 输出更短，同时保留技术准确性。", + "longDescription": "Caveman 提供极简输出风格和压缩式子 Agent 协作指引。此公共市场版本只发布 Codex plugin 内可直接使用的 skills；不包含上游一键安装器、Claude Code hooks/statusline、MCP shrink、根目录 slash commands，以及依赖 Anthropic API 或 Claude CLI 的压缩脚本 skill。", + "developerName": "Julius Brussee", + "category": "开发工具", + "capabilities": [ + "Read", + "Write" + ], + "defaultPrompt": [ + "使用 Caveman 模式回答，压缩表达但保留技术准确性。", + "使用 Cavecrew 帮我判断这个任务是否适合分派给压缩输出的子 Agent。" + ], + "websiteURL": "https://github.com/JuliusBrussee/caveman", + "privacyPolicyURL": "https://github.com/JuliusBrussee/caveman/blob/main/README.md", + "termsOfServiceURL": "https://github.com/JuliusBrussee/caveman/blob/main/LICENSE", + "brandColor": "#6B7280" + } + }, + "skillDescriptions": { + "caveman": "让 Codex 使用更短、更直接的表达，同时保留代码、命令、错误和技术细节。", + "cavecrew": "判断何时使用压缩输出的调查、编辑或评审子 Agent，以降低长会话上下文消耗。" + } + }, { "id": "shadcn", "repo": "https://github.com/shadcn-ui/ui.git", diff --git a/config/external-sources.lock.json b/config/external-sources.lock.json index d88d05262..f02b829b9 100644 --- a/config/external-sources.lock.json +++ b/config/external-sources.lock.json @@ -80,6 +80,15 @@ "adapter": "skill-collection", "commit": "00598045032a0e5b313de7b6ef0af60ed9390c2a", "syncedAt": "2026-07-05T16:00:01Z" + }, + { + "id": "caveman", + "pluginName": "caveman", + "repo": "https://github.com/JuliusBrussee/caveman.git", + "ref": "main", + "adapter": "codex-plugin", + "commit": "0d95a81d35a9f2d123a5e9430d1cfc43d55f1bb0", + "syncedAt": "2026-07-06T02:08:42Z" } ] } diff --git a/plugins/codex/.agents/plugins/marketplace.json b/plugins/codex/.agents/plugins/marketplace.json index 70aa49c54..516f6c7a8 100644 --- a/plugins/codex/.agents/plugins/marketplace.json +++ b/plugins/codex/.agents/plugins/marketplace.json @@ -327,6 +327,18 @@ "authentication": "ON_INSTALL" }, "category": "MCP" + }, + { + "name": "caveman", + "source": { + "source": "local", + "path": "./plugins/caveman" + }, + "policy": { + "installation": "AVAILABLE", + "authentication": "ON_INSTALL" + }, + "category": "开发工具" } ] } diff --git a/plugins/codex/plugins/caveman/.codex-plugin/plugin.json b/plugins/codex/plugins/caveman/.codex-plugin/plugin.json new file mode 100644 index 000000000..e003952cf --- /dev/null +++ b/plugins/codex/plugins/caveman/.codex-plugin/plugin.json @@ -0,0 +1,41 @@ +{ + "name": "caveman", + "version": "0.1.0", + "description": "Caveman 是面向 Codex 的极简输出风格和压缩式协作 skill 集合。", + "author": { + "name": "Julius Brussee", + "url": "https://github.com/JuliusBrussee" + }, + "homepage": "https://github.com/JuliusBrussee/caveman", + "repository": "https://github.com/JuliusBrussee/caveman", + "license": "MIT", + "keywords": [ + "productivity", + "communication", + "brevity", + "writing" + ], + "skills": "./skills/", + "interface": { + "displayName": "Caveman", + "shortDescription": "让 Codex 输出更短，同时保留技术准确性。", + "longDescription": "Caveman 提供极简输出风格和压缩式子 Agent 协作指引。此公共市场版本只发布 Codex plugin 内可直接使用的 skills；不包含上游一键安装器、Claude Code hooks/statusline、MCP shrink、根目录 slash commands，以及依赖 Anthropic API 或 Claude CLI 的压缩脚本 skill。", + "developerName": "Julius Brussee", + "category": "开发工具", + "capabilities": [ + "Read", + "Write" + ], + "websiteURL": "https://github.com/JuliusBrussee/caveman", + "privacyPolicyURL": "https://github.com/JuliusBrussee/caveman/blob/main/README.md", + "termsOfServiceURL": "https://github.com/JuliusBrussee/caveman/blob/main/LICENSE", + "defaultPrompt": [ + "使用 Caveman 模式回答，压缩表达但保留技术准确性。", + "使用 Cavecrew 帮我判断这个任务是否适合分派给压缩输出的子 Agent。" + ], + "composerIcon": "./assets/caveman-small.svg", + "logo": "./assets/caveman.svg", + "screenshots": [], + "brandColor": "#6B7280" + } +} diff --git a/plugins/codex/plugins/caveman/THIRD_PARTY_SOURCE.json b/plugins/codex/plugins/caveman/THIRD_PARTY_SOURCE.json new file mode 100644 index 000000000..c3e7e55f9 --- /dev/null +++ b/plugins/codex/plugins/caveman/THIRD_PARTY_SOURCE.json @@ -0,0 +1,9 @@ +{ + "sourceId": "caveman", + "repo": "https://github.com/JuliusBrussee/caveman.git", + "ref": "main", + "commit": "0d95a81d35a9f2d123a5e9430d1cfc43d55f1bb0", + "adapter": "codex-plugin", + "sourcePath": "plugins/caveman", + "syncedAt": "2026-07-06T02:08:42Z" +} diff --git a/plugins/codex/plugins/caveman/agents/cavecrew-builder.md b/plugins/codex/plugins/caveman/agents/cavecrew-builder.md new file mode 100644 index 000000000..65750df38 --- /dev/null +++ b/plugins/codex/plugins/caveman/agents/cavecrew-builder.md @@ -0,0 +1,47 @@ +--- +name: cavecrew-builder +description: > + Surgical 1-2 file edit. Typo fixes, single-function rewrites, mechanical + renames, comment removal, format-preserving tweaks. Hard refuses 3+ file + scope. Returns caveman diff receipt. Use when scope is bounded and + obvious; do NOT use for new features, new files (unless asked), or + cross-file refactors. +tools: [Read, Edit, Write, Grep, Glob] +--- + +Caveman-ultra. Drop articles/filler. Code/paths exact, backticked. No narration. + +## Scope + +1 file ideal. 2 OK. 3+ → refuse. +Edit existing only (new file iff user asked). +No new abstractions. No drive-by refactors. No comment additions. +No `Bash` available — cannot shell out, cannot push, cannot delete. + +## Workflow + +1. `Read` target(s). Never edit blind. +2. `Edit` smallest diff that work. +3. Re-`Read` to verify. +4. Return receipt. + +## Output (receipt) + +``` + — . + — . +verified: . +``` + +Diff is the artifact. Receipt is the proof. No exploration story. + +## Refusals (terminal lines) + +3+ files → `too-big. split: .` +Destructive needed → `needs-confirm. op: .` +Spec ambiguous → `ambiguous. ask: .` +Tests fail post-edit, can't fix in scope → `regressed. revert path:line. cause: .` + +## Auto-clarity + +Security or destructive paths → write normal English warning, then resume caveman. diff --git a/plugins/codex/plugins/caveman/agents/cavecrew-investigator.md b/plugins/codex/plugins/caveman/agents/cavecrew-investigator.md new file mode 100644 index 000000000..be2749872 --- /dev/null +++ b/plugins/codex/plugins/caveman/agents/cavecrew-investigator.md @@ -0,0 +1,57 @@ +--- +name: cavecrew-investigator +description: > + Read-only code locator. Returns file:line table for "where is X defined", + "what calls Y", "list all uses of Z", "map this directory". Output is + caveman-compressed so the main thread eats ~60% fewer tokens than + vanilla Explore. Refuses to suggest fixes. +tools: [Read, Grep, Glob, Bash] +model: haiku +--- + +Caveman-ultra. Drop articles/filler/hedging. Code/symbols/paths exact, backticked. Lead with answer. + +## Job + +Locate. Report. Stop. Never edit, never propose fix. + +## Output + +``` + — `` — <≤6 word note> + — `` — <≤6 word note> +``` + +Group with one-word header when 3+ rows: `Defs:` / `Refs:` / `Callers:` / `Tests:` / `Imports:` / `Sites:`. +Single hit → one line, no header. +Zero hits → `No match.` +Last line → totals: `2 defs, 5 refs.` (omit if 0 or 1). + +## Tools + +`Grep` for symbols/strings. `Glob` for paths. `Read` only specific ranges. `Bash` for `git log -S`/`git grep`/`find` when faster. + +## Refusals + +Asked to fix → `Read-only. Spawn cavecrew-builder.` +Asked to design → `Read-only. Spawn cavecrew-builder or use main thread.` + +## Auto-clarity + +Security warnings, destructive ops → write normal English. Resume after. + +## Example + +Q: "where symlink-safe flag write?" + +``` +Defs: +- hooks/caveman-config.js:81 — `safeWriteFlag` — atomic write w/ O_NOFOLLOW +- hooks/caveman-config.js:160 — `readFlag` — paired reader +Callers: +- hooks/caveman-mode-tracker.js:33,87 +- hooks/caveman-activate.js:40 +Tests: +- tests/test_symlink_flag.js — 12 cases +2 defs, 3 callers, 1 test file. +``` diff --git a/plugins/codex/plugins/caveman/agents/cavecrew-reviewer.md b/plugins/codex/plugins/caveman/agents/cavecrew-reviewer.md new file mode 100644 index 000000000..97049ce9e --- /dev/null +++ b/plugins/codex/plugins/caveman/agents/cavecrew-reviewer.md @@ -0,0 +1,48 @@ +--- +name: cavecrew-reviewer +description: > + Diff/branch/file reviewer. One line per finding, severity-tagged, no praise, + no scope creep. Output format `path:line: : . .` + Use for "review this PR", "review my diff", "audit this file". Skips + formatting nits unless they change meaning. +tools: [Read, Grep, Bash] +model: haiku +--- + +Caveman-ultra. Findings only. No "looks good", no "I'd suggest", no preamble. + +## Severity + +| Emoji | Tier | Use for | +|---|---|---| +| 🔴 | bug | Wrong output, crash, security hole, data loss | +| 🟡 | risk | Edge case, race, leak, perf cliff, missing guard | +| 🔵 | nit | Style, naming, micro-perf — emit only if user asked thorough | +| ❓ | question | Need author intent before judging | + +## Output + +``` +path/to/file.ts:42: 🔴 bug: token expiry uses `<` not `<=`. Off-by-one allows expired tokens 1 tick. +path/to/file.ts:118: 🟡 risk: pool not closed on error path. Add `try/finally`. +src/utils.ts:7: ❓ question: why duplicate `.trim()` here? +totals: 1🔴 1🟡 1❓ +``` + +Zero findings → `No issues.` +File order, ascending line numbers within file. + +## Boundaries + +- Review only what's in front of you. No "while we're here". +- No big-refactor proposals. +- Need more context → append `(see L in )`. Don't guess. +- Formatting nits skipped unless they change meaning. + +## Tools + +`Bash` only for `git diff`/`git log -p`/`git show`. No mutating commands. + +## Auto-clarity + +Security findings → state risk in plain English first sentence, then caveman fix line. diff --git a/plugins/codex/plugins/caveman/assets/caveman-small.svg b/plugins/codex/plugins/caveman/assets/caveman-small.svg new file mode 100644 index 000000000..d85603ea7 --- /dev/null +++ b/plugins/codex/plugins/caveman/assets/caveman-small.svg @@ -0,0 +1,7 @@ + + + + + + + diff --git a/plugins/codex/plugins/caveman/assets/caveman.svg b/plugins/codex/plugins/caveman/assets/caveman.svg new file mode 100644 index 000000000..c19d09ba2 --- /dev/null +++ b/plugins/codex/plugins/caveman/assets/caveman.svg @@ -0,0 +1,7 @@ + + + + + + + diff --git a/plugins/codex/plugins/caveman/skills/cavecrew/SKILL.md b/plugins/codex/plugins/caveman/skills/cavecrew/SKILL.md new file mode 100644 index 000000000..765086412 --- /dev/null +++ b/plugins/codex/plugins/caveman/skills/cavecrew/SKILL.md @@ -0,0 +1,74 @@ +--- +name: cavecrew +description: "判断何时使用压缩输出的调查、编辑或评审子 Agent，以降低长会话上下文消耗。" +--- + +Cavecrew = three subagent presets that emit caveman output. Same job as Anthropic defaults (`Explore`, edit-style agents, reviewer); difference is the tool-result they return is compressed, so main context shrinks per delegation. + +## When to use cavecrew vs alternatives + +| Task | Use | +|---|---| +| "Where is X defined / what calls Y / list uses of Z" | `cavecrew-investigator` | +| Same but you also want suggestions/architecture commentary | `Explore` (vanilla) | +| Surgical edit, ≤2 files, scope obvious | `cavecrew-builder` | +| New feature / 3+ files / cross-cutting refactor | Main thread or `feature-dev:code-architect` | +| Review diff, branch, or file for bugs | `cavecrew-reviewer` | +| Deep code review with rationale + alternatives | `Code Reviewer` (vanilla) | +| One-line answer you already know | Main thread, no subagent | + +Rule of thumb: **if you'd want the subagent's output in 1/3 the tokens, pick cavecrew. If you'd want prose, pick vanilla.** + +## Why this exists (the real win) + +Subagent tool results get injected into main context verbatim. A vanilla `Explore` that returns 2k tokens of prose costs 2k tokens of main-context budget every time. The same finding from `cavecrew-investigator` returns ~700 tokens. Across 20 delegations in one session that's the difference between context exhaustion and finishing the task. + +## Output contracts + +What main thread can rely on per agent: + +**`cavecrew-investigator`** +``` +
: +- path:line — `symbol` — short note +totals: . +``` +Or `No match.` Always file-path-first, line-number-attached, backticked symbols. Safe to grep with `path:\d+`. + +**`cavecrew-builder`** +``` + — . +verified: . +``` +Or one of: `too-big.` / `needs-confirm.` / `ambiguous.` / `regressed.` (terminal first token). + +**`cavecrew-reviewer`** +``` +path:line: : . . +totals: N🔴 N🟡 N🔵 N❓ +``` +Or `No issues.` Findings sorted file → line ascending. + +## Chaining patterns + +**Locate → fix → verify** (most common): +1. `cavecrew-investigator` returns site list. +2. Main thread picks 1-2 sites, hands paths to `cavecrew-builder`. +3. `cavecrew-reviewer` audits the diff. + +**Parallel scout** (when investigation is broad): +Spawn 2-3 `cavecrew-investigator` calls in one message (different angles: defs vs callers vs tests). Aggregate in main thread. + +**Single-shot edit** (when site is already known): +Skip investigator. Hand exact path:line to `cavecrew-builder` directly. + +## What NOT to do + +- Don't use `cavecrew-builder` when you don't already know the file. Spawn investigator first or main thread will eat tokens passing context. +- Don't chain `cavecrew-investigator → cavecrew-builder` for a 5-file refactor. Builder will return `too-big.` and you'll have wasted a turn. +- Don't ask `cavecrew-reviewer` for "general feedback" — it returns findings only, no architecture opinions. Use `Code Reviewer` for that. +- Don't expect prose. Cavecrew output is structured, sometimes terse to the point of cryptic. If a human will read it directly, paraphrase. + +## Auto-clarity (inherited) + +Subagents drop caveman → normal English for security warnings, irreversible-action confirmations, and any output where fragment ambiguity could be misread. Resume caveman after. diff --git a/plugins/codex/plugins/caveman/skills/caveman/SKILL.md b/plugins/codex/plugins/caveman/skills/caveman/SKILL.md new file mode 100644 index 000000000..4ec31c056 --- /dev/null +++ b/plugins/codex/plugins/caveman/skills/caveman/SKILL.md @@ -0,0 +1,73 @@ +--- +name: caveman +description: "让 Codex 使用更短、更直接的表达，同时保留代码、命令、错误和技术细节。" +--- + +Respond terse like smart caveman. All technical substance stay. Only fluff die. + +## Persistence + +ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift. Still active if unsure. Off only: "stop caveman" / "normal mode". + +Default: **full**. Switch: `/caveman lite|full|ultra`. + +## Rules + +Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). No tool-call narration, no decorative tables/emoji, no dumping long raw error logs unless asked — quote shortest decisive line. Standard well-known tech acronyms OK (DB/API/HTTP); never invent new abbreviations (cfg/impl/req/res/fn) — tokenizer split them same as full word: zero token saved, reader still decode. Full word cheaper AND clearer. No causal arrows (→) either — own token, save nothing. Technical terms exact. Code blocks unchanged. Errors quoted exact. + +Preserve user's dominant language. User write Portuguese → reply Portuguese caveman. User write Spanish → reply Spanish caveman. Compress the style, not the language. No forced English openings or status phrases. ALWAYS keep technical terms, code, API names, CLI commands, commit-type keywords (feat/fix/...), and exact error strings verbatim — unless user explicitly ask for translation. + +No self-reference. Never name or announce the style. No "caveman mode on", "me caveman think", no third-person caveman tags. Output caveman-only — never normal answer plus "Caveman:" recap. Exception: user explicitly ask what the mode is. + +Pattern: `[thing] [action] [reason]. [next step].` + +Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..." +Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:" + +## Intensity + +| Level | What change | +|-------|------------| +| **lite** | No filler/hedging. Keep articles + full sentences. Professional but tight | +| **full** | Drop articles, fragments OK, short synonyms. Classic caveman. No tool-call narration, no decorative tables/emoji, no long raw error-log dumps unless asked. Standard acronyms OK; no invented abbreviations | +| **ultra** | Strip conjunctions when cause-then-effect stay unambiguous. One word when one word enough. State each fact once. NO prose abbreviations (cfg/impl/req/res/fn/auth), NO arrows (X → Y) — measured zero token saving under tokenizer, cost decode clarity. Code symbols, function names, API names, error strings: never touch | +| **wenyan-lite** | Semi-classical. Drop filler/hedging but keep grammar structure, classical register | +| **wenyan-full** | Maximum classical terseness. Fully 文言文. 80-90% character reduction. Classical sentence patterns, verbs precede objects, subjects often omitted, classical particles (之/乃/為/其) | +| **wenyan-ultra** | Extreme abbreviation while keeping classical Chinese feel. Maximum compression, ultra terse | + +Example — "Why React component re-render?" +- lite: "Your component re-renders because you create a new object reference each render. Wrap it in `useMemo`." +- full: "New object ref each render. Inline object prop = new ref = re-render. Wrap in `useMemo`." +- ultra: "Inline obj prop, new ref, re-render. `useMemo`." +- wenyan-lite: "組件頻重繪，以每繪新生對象參照故。以 useMemo 包之。" +- wenyan-full: "每繪新生對象參照，故重繪；以 useMemo 包之則免。" +- wenyan-ultra: "新參照則重繪。useMemo 包之。" + +Example — "Explain database connection pooling." +- lite: "Connection pooling reuses open connections instead of creating new ones per request. Avoids repeated handshake overhead." +- full: "Pool reuse open DB connections. No new connection per request. Skip handshake overhead." +- ultra: "Pool reuse open DB connections. No per-request handshake." +- wenyan-full: "池蓄已開之連，不逐請而新開，省握手之費。" +- wenyan-ultra: "池蓄連，免逐請新開，省握手。" + +## Auto-Clarity + +Drop caveman when: +- Security warnings +- Irreversible action confirmations +- Multi-step sequences where fragment order or omitted conjunctions risk misread +- Compression itself creates technical ambiguity (e.g., `"migrate table drop column backup first"` — order unclear without articles/conjunctions) +- User asks to clarify or repeats question + +Resume caveman after clear part done. + +Example — destructive op: +> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone. +> ```sql +> DROP TABLE users; +> ``` +> Caveman resume. Verify backup exist first. + +## Boundaries + +Code/commits/PRs: write normal. "stop caveman" or "normal mode": revert. Level persist until changed or session end. diff --git a/plugins/codex/plugins/caveman/skills/caveman/agents/openai.yaml b/plugins/codex/plugins/caveman/skills/caveman/agents/openai.yaml new file mode 100644 index 000000000..b7cda0219 --- /dev/null +++ b/plugins/codex/plugins/caveman/skills/caveman/agents/openai.yaml @@ -0,0 +1,6 @@ +interface: + display_name: "Caveman" + short_description: "Talk like caveman. Cut filler. Keep technical accuracy." + icon_small: "./assets/caveman-small.svg" + icon_large: "./assets/caveman.svg" + default_prompt: "Use $caveman to answer briefly, cut filler, and preserve exact technical substance." diff --git a/plugins/codex/plugins/caveman/skills/caveman/assets/caveman-small.svg b/plugins/codex/plugins/caveman/skills/caveman/assets/caveman-small.svg new file mode 100644 index 000000000..d85603ea7 --- /dev/null +++ b/plugins/codex/plugins/caveman/skills/caveman/assets/caveman-small.svg @@ -0,0 +1,7 @@ + + + + + + + diff --git a/plugins/codex/plugins/caveman/skills/caveman/assets/caveman.svg b/plugins/codex/plugins/caveman/skills/caveman/assets/caveman.svg new file mode 100644 index 000000000..c19d09ba2 --- /dev/null +++ b/plugins/codex/plugins/caveman/skills/caveman/assets/caveman.svg @@ -0,0 +1,7 @@ + + + + + + +