<sub>🌐 <a href="README.md">English</a> · 中文</sub>

# CC Harness Skills

> *「把有趣的 demo 和稳定的工具链区分开来的那些部分：记忆、压缩、验证、路由、主动任务。」*

[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-6%20bundles-blueviolet)](#skill-包)
[![skills.sh](https://skills.sh/b/LearnPrompt/cc-harness-skills)](https://skills.sh/LearnPrompt/cc-harness-skills)
[![Multi-Runtime](https://img.shields.io/badge/Runtime-Claude%20Code%20%C2%B7%20Codex%20%C2%B7%20OpenClaw-green)](#快速开始)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

从公开镜像的 `CC` coding-agent 代码库中蒸馏出的可移植 agent skill，经过重写后可以安装到 `Claude Code`、`Codex` 和 `OpenClaw`，不依赖任何私有运行时内部实现。

## 快速开始

一行安装（任何兼容 skills 的 agent）：

```bash
# 全部六个 skill
npx skills add LearnPrompt/cc-harness-skills -g

# 或只装一个
npx skills add LearnPrompt/cc-harness-skills -s verification-gate -g
```

先跑一遍基础的 bundle 检查：

```bash
bash ./skills/check_all.sh
```

也可以手动把某个 skill 复制进宿主运行时：

```bash
mkdir -p ~/.claude/skills
cp -R ./skills/dream-memory ~/.claude/skills/
```

然后在 `Claude Code` 里调用：

```text
Use /dream-memory to consolidate the memory directory before we continue.
```

```bash
mkdir -p ~/.codex/skills
cp -R ./skills/dream-memory ~/.codex/skills/
```

然后在 `Codex` 里调用：

```text
Use /dream-memory and consolidate recent memory files into one stable index.
```

```bash
mkdir -p ~/.openclaw/workspace/skills
cp -R ./skills/dream-memory ~/.openclaw/workspace/skills/
```

然后在 `OpenClaw` 里检查：

```bash
openclaw skills info dream-memory
```

检查通过后发布到 ClawHub：

```bash
bash ./skills/publish_all.sh 0.1.0
```

这个仓库不是源码堆场，而是一个清理过的 skill 包：

- prompt 提取成可复用模板
- 与宿主无关的辅助脚本
- 可移植的 `SKILL.md` bundle
- 面向公开分发的发布与冒烟测试文档

如果你在用 coding agent 做东西，以下这些通常就是把有趣的 demo 和稳定的工具链区分开来的部分：

- 保持有用而不是逐渐腐烂的记忆
- 保留用户纠正的对话压缩
- 不轻信「done」的验证
- 不污染主上下文的多 agent 路由
- 有明确边界的主动任务

这个仓库把这些模式打包成六个可安装的 skill。

## 为什么做这个

大多数 agent 仓库都面临同样的几个难题：

- 如何让记忆保持有用，而不是存一堆过时的代码事实
- 如何压缩长对话而不丢失用户的纠正
- 如何验证声称的完成，而不是直接相信它
- 如何协调多个 agent 而不把主上下文变成垃圾场
- 如何加轻量的主动行为而不造出一个危险的守护进程

本仓库的六个 skill 把这些模式打包成开箱即用的 bundle。

## 适合谁

- 想改善 agent 行为、但不想 fork 一整个 agent 产品的开发者
- 在用 `Claude Code`、`Codex` 或 `OpenClaw`、想要一层共享 skill 的团队
- 在研究 `CC` 式 harness 设计、但需要可发布、可移植成果的人
- 想要「prompt + 脚本」而不是只有 prompt 的任何人

## Skill 包

| 公开名 | Slug | 干什么 | 最佳宿主 |
| --- | --- | --- | --- |
| CC Dream Memory | `dream-memory` | 把日志、近期会话和主题记忆整合成一份简短耐用的记忆索引。 | Claude Code, Codex, OpenClaw |
| CC Memory Extractor | `memory-extractor` | 从近期对话中提取耐用的 `user`、`feedback`、`project`、`reference` 记忆。 | Claude Code, Codex, OpenClaw |
| CC Verification Gate | `verification-gate` | 实现完成后跑一遍只读挑战，把「验证过的完成」和「仅声称的完成」区分开。 | Claude Code, Codex |
| CC Swarm Coordinator | `swarm-coordinator` | 把大任务拆成研究、综合、实现、验证四段，worker 数量有上限。 | Claude Code, Codex, OpenClaw |
| CC Context Compressor | `structured-context-compressor` | 为长会话和交接生成九段式续接摘要。 | Claude Code, Codex, OpenClaw |
| CC Kairos Lite | `kairos-lite` | 添加带调度、休眠、简报和过期规则的轻量主动任务。 | Claude Code, OpenClaw |

每个 bundle 位于 [`skills/`](/Users/carl/Downloads/codegod/skills/README.md)，包含：

- `SKILL.md`
- `references/prompt-template.md`
- `references/source-notes.md`
- `scripts/...`
- `README.md`

## 从哪开始

如果只想先试三个，建议这三个：

1. 装 `dream-memory`
2. 装 `verification-gate`
3. 装 `structured-context-compressor`

这样你就有了一套记忆工作流、一道质量门、一份续接产物——这是感受这个仓库有没有用的最快方式。

## 发布文档

- 发布者指南：[`skills/README.md`](/Users/carl/Downloads/codegod/skills/README.md)
- 发布顺序与文案：[`skills/RELEASE_PLAN.md`](/Users/carl/Downloads/codegod/skills/RELEASE_PLAN.md)
- 冒烟测试报告：[`skills/TEST_REPORT.md`](/Users/carl/Downloads/codegod/skills/TEST_REPORT.md)

## 命名

推荐的公开 GitHub 仓库名：`cc-harness-skills`

不错的备选：

- `cc-agent-skills`
- `cc-harness-kit`
- `cc-portable-skills`

公开命名刻意使用 `CC`：它标示了想法的来源，又不把完整的厂商产品名硬编码进仓库身份。

## 已验证内容

最新冒烟测试状态：

- `Claude Code`：六个 skill 全部加载成功
- `OpenClaw`：六个 skill 均解析为 `Ready`
- `Codex`：bundle 结构已验证；运行时冒烟测试待本地认证后进行

完整报告：[`skills/TEST_REPORT.md`](/Users/carl/Downloads/codegod/skills/TEST_REPORT.md)

## 项目结构

```text
skills/
  dream-memory/
  memory-extractor/
  verification-gate/
  swarm-coordinator/
  structured-context-compressor/
  kairos-lite/
```

内部工作笔记和不可发布的本地实验仍在 `.codex/skills/` 下，但本项目的公开发布面是根目录的 `skills/`。

---

<div align="center">

**更多好用 Skill · More Skills** → [learnprompt.pro/skills](https://learnprompt.pro/skills/)

[鲁班·Skill打磨](https://github.com/LearnPrompt/luban-skill) · [庖丁·博主蒸馏](https://github.com/LearnPrompt/paoding-skill) · [蔡伦·对话造纸](https://github.com/LearnPrompt/cailun-skill) · [阿福·LLM Todo](https://github.com/LearnPrompt/afu-llm-todo) · [愚公·Loop工程](https://github.com/LearnPrompt/loop-engineering) · [搭子·结对开发](https://github.com/LearnPrompt/partner-skill) · [AI雷达·零API资讯](https://github.com/LearnPrompt/ai-news-radar)

[淘金小镇·ClawHub日榜](https://github.com/LearnPrompt/skillrush-town) · [Irasutoya·正文配图](https://github.com/LearnPrompt/carl-irasutoya-illustrations) · [Humanize PPT·演讲系统](https://github.com/LearnPrompt/humanize-ppt) · [CC Harness·六件套](https://github.com/LearnPrompt/cc-harness-skills) · [微信读书教练](https://github.com/LearnPrompt/carl-weread) · [X Article发布](https://github.com/LearnPrompt/x-article-publisher-skill)

<sub>**[LearnPrompt](https://github.com/LearnPrompt) 出品** · 公众号「卡尔的AI沃茨」 · [X @aiwarts](https://x.com/aiwarts)</sub>

</div>
