Skip to content

Commit ae650c2

Browse files
committed
Release v6.2.1 inherited ccb config skill
1 parent 573aaf3 commit ae650c2

35 files changed

Lines changed: 1249 additions & 156 deletions

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
## Unreleased
44

5+
## v6.2.1 (2026-05-18)
6+
7+
### Inherited CCB Config Skill Release
8+
9+
- **Inherited `ccb_config` Skill Added**: Claude and Codex installs now inherit a `ccb_config` skill for designing `.ccb/ccb.config`, choosing roles/providers/worktree layout, and updating shared plus per-agent CCB memory.
10+
- **Inherited Skill Layout Consolidated**: CCB-owned inherited skills now live under `inherit_skills/`; optional `useful_tools/` remain user-installable tools and are not inherited by default.
11+
- **Ask Guidance Simplified**: injected ask reply guidance is shorter, English-only in source text, skips nested-routing instructions in every ask body, and recognizes more explicit-output requests.
12+
- **Project Memory Wording Simplified**: generated project/runtime memory now uses shorter submit-once guidance while keeping callback and silence routing rules available where they belong.
13+
- **Config Memory Routing Clarified**: `ccb_config` memory patterns prefer direct owner-to-next-owner callback handoffs and separate root work packages for parallel chains, without claiming single-task multi-callback fan-in.
14+
515
## v6.2.0 (2026-05-17)
616

717
### Callback Ask Chain Release

README.md

Lines changed: 37 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
<img src="https://img.shields.io/badge/Every_Model_Controllable-CF1322?style=for-the-badge" alt="Every Model Controllable">
88
</p>
99

10-
[![Version](https://img.shields.io/badge/version-6.2.0-orange.svg)]()
10+
[![Version](https://img.shields.io/badge/version-6.2.1-orange.svg)]()
1111
[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
1212

1313
**English** | [Chinese](README_zh.md)
@@ -74,10 +74,10 @@ Build project-local teams with roles, pane layout, provider state, worktree isol
7474
<details>
7575
<summary><b>Latest release highlights</b></summary>
7676

77-
- **Callback ask chains are supported**: active agents can use `ccb ask --callback <agent>` when a child result is needed before replying to the original caller.
78-
- **Nested ask routing is explicit**: plain nested `ask` from an active CCB task is rejected; use `--callback` for needed results or `--silence` for independent no-result-needed work.
79-
- **Callback routing is durable**: CCB records callback edges, resumes the parent as a continuation task, and repairs crash windows before submitting missed continuations.
80-
- **Ask skills explain the workflow**: Claude, Codex, and Droid ask skills now document callback delegation and stop-after-submit behavior.
77+
- **Inherited `ccb_config` skill added**: Claude and Codex installs now include a CCB-owned skill for designing `.ccb/ccb.config` and team memory.
78+
- **Inherited skills moved under `inherit_skills/`**: CCB-owned skills are inherited automatically, while optional `useful_tools/` remain user-installable.
79+
- **Ask guidance is shorter**: CCB injects concise English reply guidance, avoids repeating nested-routing instructions in every ask body, and recognizes more explicit-output requests.
80+
- **Memory routing is clearer**: `ccb_config` role memory favors direct owner-to-next-owner handoffs and separate root work packages for parallel chains.
8181

8282
See [Release Notes](#release-notes) for the full history.
8383

@@ -103,6 +103,25 @@ Tmux copy/paste: drag with the left mouse button to copy, and use `Ctrl+Shift+V`
103103

104104
`.ccb/ccb_memory.md` is the project-wide shared memory document.
105105

106+
<details>
107+
<summary><b>Config Design Skill</b></summary>
108+
109+
Use `ccb_config` when you want an agent to design or update the CCB team instead of editing config by hand. It is inherited by Claude and Codex installs and focuses on three user-authored files:
110+
111+
- `.ccb/ccb.config` for the team, provider choices, pane layout, and worktree policy
112+
- `.ccb/ccb_memory.md` for shared project workflow guidance
113+
- `.ccb/agents/<agent>/memory.md` for per-agent role guidance
114+
115+
Invoke it from a supported provider skill surface, for example:
116+
117+
```text
118+
$ccb_config Design a team for a Python library with one coordinator, two worktree implementation agents, and one reviewer.
119+
```
120+
121+
The skill helps choose agent names, providers, `inplace` versus `git-worktree`, compact layout syntax, and whether role instructions belong in shared or per-agent memory. It validates that `.ccb/ccb.config` is the active authority and tells you to restart CCB after file changes are complete.
122+
123+
</details>
124+
106125
<details>
107126
<summary><b>Layout</b></summary>
108127

@@ -186,7 +205,7 @@ CCB v6 currently supports `ccb update` on Linux, macOS, and WSL. A major upgrade
186205
If you installed from a git checkout with `./install.sh install`, that install now runs in source dev mode:
187206

188207
- Global `ccb` and `ask` link back to the checkout instead of using a copied snapshot
189-
- CCB-owned skills and helper scripts also follow the live source tree
208+
- CCB-owned inherited skills under `inherit_skills/` and helper scripts also follow the live source tree
190209
- Source installs do not participate in startup auto-update prompts
191210
- Stay on the source/dev track with `git pull` or by switching commits, then rerun `./install.sh install`
192211
- Or run `ccb update` to install the latest stable release and repoint global `ccb` links to the managed release install
@@ -320,6 +339,16 @@ Thanks to the [Linux.do community](https://linux.do) for testing, feedback, and
320339
Historical note: older release notes below may mention `askd`, legacy flags, or removed commands. Those references are kept only as changelog history and do not redefine the current CLI surface.
321340

322341
<details open>
342+
<summary><b>v6.2.1</b> - Inherited CCB Config Skill Release</summary>
343+
344+
- Adds inherited Claude and Codex `ccb_config` skills for designing `.ccb/ccb.config`, choosing agent roles/providers/worktree layout, and updating shared plus per-agent memory.
345+
- Moves CCB-owned inherited skills under `inherit_skills/` while keeping optional `useful_tools/` user-installable rather than inherited.
346+
- Shortens injected ask reply guidance, removes nested-routing text from every ask body, keeps injected source text English-only, and expands explicit-output detection.
347+
- Simplifies project/runtime memory wording and updates `ccb_config` memory-routing examples for direct callback handoffs and separate root work packages.
348+
349+
</details>
350+
351+
<details>
323352
<summary><b>v6.2.0</b> - Callback Ask Chain Release</summary>
324353

325354
- Adds `ccb ask --callback <agent>` so active agents can delegate work and receive the child result later as a continuation task.
@@ -981,7 +1010,7 @@ See [CHANGELOG.md](CHANGELOG.md) for full details.
9811010

9821011
- **Zombie Cleanup**: `ccb kill -f` now cleans up orphaned tmux sessions globally (sessions whose parent process has exited)
9831012
- **Mounted Skill**: Optimized to use `pgrep` for daemon detection (~4x faster), extracted to standalone `ccb-mounted` script
984-
- **Droid Skills**: Added full skill set (cask/gask/lask/oask + ping/pend variants) to `droid_skills/`
1013+
- **Droid Skills**: Added full skill set (cask/gask/lask/oask + ping/pend variants) to the provider skill assets
9851014
- **Install**: Added `install_droid_skills()` to install Droid skills to `~/.droid/skills/`
9861015

9871016
</details>
@@ -1110,7 +1139,7 @@ Highlights:
11101139
### v5.0.6
11111140
- **Zombie Cleanup**: `ccb kill -f` cleans up orphaned tmux sessions globally
11121141
- **Mounted Skill**: Optimized with `pgrep`, extracted to `ccb-mounted` script
1113-
- **Droid Skills**: Full skill set added to `droid_skills/`
1142+
- **Droid Skills**: Full skill set added to the provider skill assets
11141143

11151144
### v5.0.5
11161145
- **Droid**: Add delegation tools (`ccb_ask_*` and `cask/gask/lask/oask`) plus `ccb droid setup-delegation` for MCP install

README_zh.md

Lines changed: 34 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
<img src="https://img.shields.io/badge/模型皆可控-CF1322?style=for-the-badge" alt="模型皆可控">
88
</p>
99

10-
[![Version](https://img.shields.io/badge/version-6.2.0-orange.svg)]()
10+
[![Version](https://img.shields.io/badge/version-6.2.1-orange.svg)]()
1111
[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()
1212

1313
[English](README.md) | **中文**
@@ -74,10 +74,10 @@
7474
<details>
7575
<summary><b>最新版本亮点</b></summary>
7676

77-
- **支持 callback ask 链式调用**正在处理 CCB 任务的 agent 可用 `ccb ask --callback <agent>` 委派必须等待结果的子任务
78-
- **Nested ask 路由变为显式规则**active CCB task 内 plain nested `ask` 会被拒绝;需要结果用 `--callback`,独立无需结果的工作用 `--silence`
79-
- **Callback 路由可持久恢复**:CCB 会记录 callback edge,把子任务结果作为 continuation task 交回父 agent,并修复重启窗口里的漏交 continuation
80-
- **Ask skill 已补齐工作流说明**Claude、Codex 和 Droid ask skill 现在记录 callback 委派和提交后停止的规则
77+
- **新增继承式 `ccb_config` skill**Claude 和 Codex 安装现在会继承 CCB 自带的配置设计 skill,用于设计 `.ccb/ccb.config` 和团队记忆
78+
- **继承式 skill 统一到 `inherit_skills/`**:CCB 自带 skill 自动继承,`useful_tools/` 保持为用户按需安装的可选工具
79+
- **Ask guidance 更短**:CCB 注入简洁英文回复指引,不再给每个 ask body 重复 nested-routing 说明,并识别更多显式完整输出要求
80+
- **记忆路由更清晰**`ccb_config` 角色记忆示例强调 owner-to-next-owner 直接交接,以及并行链路使用独立 root work package
8181

8282
完整历史见 [新版本记录](#新版本记录)
8383

@@ -103,6 +103,25 @@ tmux 复制粘贴:鼠标左键拖拽即可复制,`Ctrl+Shift+V` 粘贴。
103103

104104
`.ccb/ccb_memory.md` 是项目全局记忆文档。
105105

106+
<details>
107+
<summary><b>配置设计 Skill</b></summary>
108+
109+
当你希望 agent 帮你设计或更新 CCB 团队,而不是手写配置时,可以使用 `ccb_config`。它会被 Claude 和 Codex 安装继承,重点维护三个用户可编辑文件:
110+
111+
- `.ccb/ccb.config`:团队、provider、pane layout 和 worktree 策略
112+
- `.ccb/ccb_memory.md`:项目级共享工作流记忆
113+
- `.ccb/agents/<agent>/memory.md`:每个 agent 的角色记忆
114+
115+
在支持 skill 的 provider 里可以这样调用:
116+
117+
```text
118+
$ccb_config 为一个 Python library 设计团队:一个 coordinator、两个 worktree 实现 agent、一个 reviewer。
119+
```
120+
121+
这个 skill 会帮助选择 agent 名称、provider、`inplace` / `git-worktree`、compact layout 语法,以及哪些说明应写入共享记忆或 per-agent memory。它会验证 `.ccb/ccb.config` 是当前配置 authority,并在文件修改完成后提醒你重启 CCB。
122+
123+
</details>
124+
106125
<details>
107126
<summary><b>布局</b></summary>
108127

@@ -311,6 +330,16 @@ ccb reinstall
311330
历史说明:下面较旧的发布记录里仍可能出现 `askd`、旧 flag 或已移除命令。这些内容仅作为 changelog 历史保留,不代表当前 CLI 入口。
312331

313332
<details open>
333+
<summary><b>v6.2.1</b> - Inherited CCB Config Skill Release</summary>
334+
335+
- 新增继承式 Claude / Codex `ccb_config` skill,用于设计 `.ccb/ccb.config`、选择 agent 角色/provider/worktree layout,并更新共享和 per-agent memory。
336+
- 将 CCB 自带继承式 skill 统一放到 `inherit_skills/`,同时保持 `useful_tools/` 为用户按需安装的可选工具,不默认继承。
337+
- 缩短 ask reply guidance,不再在每个 ask body 注入 nested-routing 说明,注入源文本保持英文,并扩展显式完整输出识别。
338+
- 简化 project/runtime memory wording,并更新 `ccb_config` memory-routing 示例,强调直接 callback 交接和独立 root work package。
339+
340+
</details>
341+
342+
<details>
314343
<summary><b>v6.2.0</b> - Callback Ask Chain Release</summary>
315344

316345
- 新增 `ccb ask --callback <agent>`,让 active agent 可委派子任务,并在之后以 continuation task 接收子任务结果。

VERSION

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
6.2.0
1+
6.2.1

ccb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ backend_env = get_backend_env()
2121
if backend_env and not os.environ.get("CCB_BACKEND_ENV"):
2222
os.environ["CCB_BACKEND_ENV"] = backend_env
2323

24-
VERSION = "6.2.0"
24+
VERSION = "6.2.1"
2525
GIT_COMMIT = "release"
2626
GIT_DATE = "2026-05-11"
2727

docs/ccb-project-shared-memory-plan.md

Lines changed: 9 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -138,26 +138,18 @@ communication.
138138
````md
139139
# CCB Project Memory
140140

141-
This project is managed by CCB as a visible multi-agent workspace.
141+
This project uses CCB for visible multi-agent collaboration.
142142

143-
## Agent Awareness
143+
## Collaboration
144144

145145
- You are one agent in a CCB-managed project team.
146-
- Other configured agents may be available in the same project.
147-
- When work should be handled, reviewed, or cross-checked by another visible
148-
project agent, use CCB `ask`.
149-
- Prefer CCB `ask` over provider-native hidden subagents for project-level
150-
collaboration.
151-
- When delegating, include the goal, relevant files, current assumptions, and
152-
expected output.
153-
- When replying to another agent, be concrete: include findings, changed files,
154-
blockers, and verification results.
146+
- Use CCB `ask` for project-level collaboration with configured agents.
147+
- Delegate with the goal, scope/files, assumptions, expected output, and verification needs.
148+
- Reply concisely with findings, changes, verification, blockers, and risks when relevant.
155149

156150
## Ask Communication
157151

158-
Use CCB `ask` as an asynchronous handoff channel.
159-
160-
Preferred provider form, when slash commands are available:
152+
Preferred form:
161153

162154
```text
163155
/ask <agent> <message>
@@ -171,15 +163,9 @@ $MESSAGE
171163
EOF
172164
```
173165

174-
After submitting, stop. Do not wait for the reply, poll status, or run
175-
observer commands such as `pend`, `watch`, or `ping` unless the user explicitly
176-
asks for diagnostics.
177-
178-
When this agent is already handling an active CCB ask task and delegates work
179-
needed to finish that same task, use `ask --callback` so the child result
180-
returns as a continuation task. Use `ask --silence` only for independent work
181-
whose result is not needed by the active task. Plain nested `ask` from an active
182-
task is rejected by CCB.
166+
- Submit once, then stop. Do not wait, poll, or run `pend`/`watch`/`ping` unless diagnostics were requested.
167+
- During an active CCB ask task, use `ask --callback` when a child result is needed to finish; use `ask --silence` only for independent no-result-needed work.
168+
- Plain nested `ask` from an active task is rejected by CCB.
183169
````
184170

185171
## Memory Bundle Model

docs/current-project-structure.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -736,8 +736,9 @@ Meaning:
736736

737737
### Still co-located but not part of the clean core
738738

739-
- `claude_skills/`, `codex_skills/`, `droid_skills/`
740-
provider-specific prompt/skill assets
739+
- `inherit_skills/`
740+
provider-specific prompt/skill assets installed by CCB and inherited by
741+
managed provider homes
741742
- `bin/`
742743
legacy provider wrappers plus current helper scripts
743744
- `mcp/ccb-delegation/`
File renamed without changes.
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,8 @@ metadata:
88
Use this only for `/ask <target> <message...>`.
99

1010
- `TARGET` = first token after `/ask`.
11-
- `MESSAGE` = exact raw remainder; forward verbatim.
11+
- `MESSAGE` = exact raw remainder sent as the task body.
12+
- `ask` may append reply guidance unless the message already contains explicit output requirements.
1213
- `TARGET=all` broadcasts.
1314
- Plain `ask` injects concise-reply guidance while still delivering the full reply body.
1415
- Use `--compact` when the caller wants an actively distilled answer, such as review findings, status, risks, blockers, or next actions.

claude_skills/ask/SKILL.md.powershell renamed to inherit_skills/claude_skills/ask/SKILL.md.powershell

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ metadata:
77

88
Use this only for `/ask <target> <message...>`.
99

10-
- `TARGET` = first token; `MESSAGE` = raw remainder, forwarded verbatim.
10+
- `TARGET` = first token; `MESSAGE` = raw remainder sent as the task body.
11+
- `ask` may append reply guidance unless the message already contains explicit output requirements.
1112
- `TARGET=all` broadcasts.
1213
- Plain `ask` injects concise-reply guidance while still delivering the full reply body.
1314
- Use `--compact` when the caller wants an actively distilled answer, such as review findings, status, risks, blockers, or next actions.

0 commit comments

Comments
 (0)