Skip to content

chore: retire github-collaboration workflow #19

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zaurakworks merged 1 commit into from
Aug 17, 2026
Merged

chore: retire github-collaboration workflow #19

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 1 addition & 15 deletions .agents/plugins/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@
},
{
"name": "orchestrated-collaboration",
"version": "0.2.6",
"version": "0.2.7",
"source": {
"source": "local",
"path": "./plugins/orchestrated-collaboration"
Expand All @@ -82,20 +82,6 @@
},
"category": "Productivity"
},
{
"name": "github-collaboration",
"version": "0.3.18",
"description": "Drive a GitHub issue subtree from any Session, including bounded continuation, safe natural owner decisions, contract compaction, delivery, integration, and reclamation.",
"source": {
"source": "local",
"path": "./plugins/github-collaboration"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Productivity"
},
{
"name": "resource-observability",
"version": "0.2.4",
Expand Down
8 changes: 1 addition & 7 deletions .claude-plugin/marketplace.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,20 +28,14 @@
},
{
"name": "orchestrated-collaboration",
"version": "0.2.6",
"version": "0.2.7",
"source": "./plugins/orchestrated-collaboration"
},
{
"name": "adaptive-problem-solving",
"version": "0.2.12",
"source": "./plugins/adaptive-problem-solving"
},
{
"name": "github-collaboration",
"version": "0.3.18",
"description": "Drive a GitHub issue subtree from any Session, including bounded continuation, safe natural owner decisions, contract compaction, delivery, integration, and reclamation.",
"source": "./plugins/github-collaboration"
},
{
"name": "resource-observability",
"version": "0.2.4",
Expand Down
23 changes: 7 additions & 16 deletions README.md
View file
Open in desktop

Large diffs are not rendered by default.

225 changes: 0 additions & 225 deletions docs/issue-workflow-walkthrough.md
View file
Open in desktop

This file was deleted.

10 changes: 5 additions & 5 deletions docs/lifecycle.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ git -C <repo-root> worktree add <worktree-root>/<分支> -b <分支>

| 项 | 处理 | 依据 |
| --- | --- | --- |
| Skill 数量 | 上限 13 | 原基线 12；负责人在 [`agent-control#57`](https://github.com/zaurakworks/agent-control/issues/57) 窄授权新增一个 `skill-maintenance` |
| Skill 数量 | 上限 7 | 历史授权上限曾到 13；[`agent-plugins#18`](https://github.com/zaurakworks/agent-plugins/issues/18) 退役六项后收紧到当前实际数量，不保留增长余量 |
| 单项 L1 description | 上限 1000 UTF-8 字节 | 2026-08-11 普通 Codex、Orca Codex、Claude Code 三端可见性实测 |
| L2 主合同 | 实测报告，不设总字节上限 | 只在选择 Skill 后加载；逐项行为审阅决定缩减或退役 |
| L3 按需引用 | 递归实测报告，不设总字节上限 | 只有真实路由才进入运行上下文；嵌套引用仍属于维护面 |
Expand All @@ -99,7 +99,7 @@ git -C <repo-root> worktree add <worktree-root>/<分支> -b <分支>

原 `209000` 字节硬门已由 [`agent-plugins#16`](https://github.com/zaurakworks/agent-plugins/issues/16) 退役：它只扫描 `references/` 顶层 Markdown，漏掉嵌套方法卡；同时把 L2、L3 和维护面错误当成同一批上下文字节。把漏项补进旧上限只会得到更大的错误数字，不解决口径问题。

数量门继续要求「加」伴随「换」。移动文字只有在正文保留明确按需路由时才可能降低运行成本，且不降低维护复杂度；真正优化优先删除行为、状态机、依赖和重复调用者。逐 Skill 的既有棘轮暂保留为历史谈判记录，后续在对应 Skill 审阅中逐项裁决。
数量门继续要求「加」伴随「换」。移动文字只有在正文保留明确按需路由时才可能降低运行成本，且不降低维护复杂度；真正优化优先删除行为、状态机、依赖和重复调用者。历史 12→13 授权与已退役字节门继续留在声明中供审计，不构成把当前上限从 7 调回 13 的授权。

## 四、写作判据

Expand All @@ -122,13 +122,13 @@ git -C <repo-root> worktree add <worktree-root>/<分支> -b <分支>
| 必须声明失效条件与最少复核步骤 | 2 拦截 | CI 断言存在且非空 |
| `suspect` 标记的结构完整性 | 2 拦截 | CI 断言同时有命中条件与日期 |
| Skill 数量不得越过已授权上限；L1／L2／L3 与维护面必须可复现 | 2 拦截 | CI 断言 `complexityBudget` 并递归实测 |
| 退役必须确认三处都不存在 | 3 生成 | `plugin_release retire` |
| 复核到期提醒 | 3 生成 | `plugin_release check` 本地报告 |
| 来源退役必须确认目录、两份 Marketplace 与当前路由都不存在 | 2 拦截 | CI 负例 |
| 运行端退役必须逐端卸载并回读 | **4 文本** | 来源仓无法代替目标客户端回执 |
| 开发不在生产检出里做 | **4 文本** | 无（只影响漂移检测能否判定，不影响会话行为） |
| 被标记 `suspect` 后不得再作判据 | **4 文本** | 无 |
| 写作判据（leading word／完成门／退出） | **4 文本** | 无 |

两条停在第 4 层的规则是本文的已知弱点，不是遗漏。它们上移的条件分别是：找到「作为判据使用」的可观察信号；找到不制造合规假象的完成门判据。
四条停在第 4 层的规则是本文的已知弱点，不是遗漏。它们上移的条件分别是：有可访问的目标客户端回执；恢复能识别生产检出的发布前置；找到「作为判据使用」的可观察信号；找到不制造合规假象的完成门判据。

## 边界

Expand Down
108 changes: 15 additions & 93 deletions docs/skills-overview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,25 +6,19 @@
这是给人看的入口：每个 Skill 替你做什么、什么时候会用到、你怎么看出它在起作用，
以及它在不同加载层和维护面上的实测体积。`SKILL.md` 是给 Agent 执行的行为合同，优先保证触发、硬门、分支和退出完整，不是按顺序阅读的教程；只有维护或审查行为时才需要下钻。

当前 13 个 Skill：L1 descriptions 7,703 字节；L2 主合同 149,332 字节；L3 按需 references 204,984 字节；递归维护面合计 354,316 字节。
当前 7 个 Skill：L1 descriptions 4,189 字节；L2 主合同 59,706 字节；L3 按需 references 167,608 字节；递归维护面合计 227,314 字节。

L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加载；L3 只在正文明确路由后按需加载。三者不是同一个运行上下文预算。维护面递归计量全部可执行 Markdown，但不设置会诱导搬运文字的字节上限。

| Skill | 版本 | L1 描述 | L2 主合同 | L3 引用 | 维护面占比 | 上次复核 |
| --- | --- | ---: | ---: | ---: | ---: | --- |
| [adaptive-problem-solving](#adaptive-problem-solving) | 0.2.12 | 703 B | 8.6 KB | 123.4 KB | 38.2% | 2026-08-15 |
| [issue-workflow](#issue-workflow) | 0.3.18 | 658 B | 23.7 KB | 36.5 KB | 17.4% | 2026-08-15 |
| [orchestrated-collaboration](#orchestrated-collaboration) | 0.2.6 | 876 B | 21.2 KB | 28.9 KB | 14.5% | 2026-08-15 |
| [self-improvement](#self-improvement) | 0.1.7 | 673 B | 8.8 KB | 7.2 KB | 4.6% | 2026-08-15 |
| [pr-integration](#pr-integration) | 0.3.18 | 581 B | 15.6 KB | 0.0 KB | 4.5% | 2026-08-15 |
| [issue-delivery](#issue-delivery) | 0.3.18 | 554 B | 15.2 KB | 0.0 KB | 4.4% | 2026-08-15 |
| [objective-to-issues](#objective-to-issues) | 0.3.18 | 491 B | 13.0 KB | 0.0 KB | 3.8% | 2026-08-15 |
| [operating-ledger-maintenance](#operating-ledger-maintenance) | 0.3.18 | 749 B | 11.5 KB | 0.0 KB | 3.3% | 2026-08-15 |
| [resource-observability](#resource-observability) | 0.2.4 | 608 B | 5.6 KB | 4.1 KB | 2.8% | 2026-08-15 |
| [issue-contract-compaction](#issue-contract-compaction) | 0.3.18 | 481 B | 8.6 KB | 0.0 KB | 2.5% | 2026-08-15 |
| [knowledge-maintenance](#knowledge-maintenance) | 0.1.3 | 644 B | 6.3 KB | 0.0 KB | 1.8% | 2026-08-15 |
| [grilling](#grilling) | 0.1.2 | 351 B | 3.9 KB | 0.0 KB | 1.1% | 2026-08-15 |
| [skill-maintenance](#skill-maintenance) | 0.1.0 | 334 B | 3.8 KB | 0.0 KB | 1.1% | 2026-08-16 |
| [adaptive-problem-solving](#adaptive-problem-solving) | 0.2.12 | 703 B | 8.6 KB | 123.4 KB | 59.5% | 2026-08-15 |
| [orchestrated-collaboration](#orchestrated-collaboration) | 0.2.7 | 876 B | 21.3 KB | 28.9 KB | 22.6% | 2026-08-15 |
| [self-improvement](#self-improvement) | 0.1.7 | 673 B | 8.8 KB | 7.2 KB | 7.2% | 2026-08-15 |
| [resource-observability](#resource-observability) | 0.2.4 | 608 B | 5.6 KB | 4.1 KB | 4.4% | 2026-08-15 |
| [knowledge-maintenance](#knowledge-maintenance) | 0.1.3 | 644 B | 6.3 KB | 0.0 KB | 2.9% | 2026-08-15 |
| [grilling](#grilling) | 0.1.2 | 351 B | 3.9 KB | 0.0 KB | 1.8% | 2026-08-15 |
| [skill-maintenance](#skill-maintenance) | 0.1.0 | 334 B | 3.8 KB | 0.0 KB | 1.7% | 2026-08-16 |

## adaptive-problem-solving

Expand All @@ -36,19 +30,7 @@ L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加

**什么会让它失效** 方法登记面的证据等级分布与登记面 README 声明不符；或三端 description 可见预算的实测基线（2026-08-11 测得 1000 UTF-8 字节）被新的实测推翻。

所属 Plugin `adaptive-problem-solving` `0.2.12`｜L1 703 B｜L2 8.6 KB｜L3 123.4 KB｜递归维护面 132.0 KB（占总维护面 38.2%）｜Agent 行为合同（维护／审查时读取）[`plugins/adaptive-problem-solving/skills/adaptive-problem-solving/SKILL.md`](../plugins/adaptive-problem-solving/skills/adaptive-problem-solving/SKILL.md)

## issue-workflow

**它替你做什么** 让任何一个 Session 只凭远端 Issue 就知道自己该干什么、干到哪、能不能关。

**什么时候用** 手上有明确 Issue 时。没有 Issue 时它不挑活，会退回经营总账。

**你怎么知道它在起作用** Issue 上出现状态判定与关闭回执，且全链只有它一处作出这个判定。

**什么会让它失效** GitHub 原生 sub-issue 关系、Project v2 字段写入语义或 Issue 关闭权限模型发生变化，使正文描述的建图与状态判定不再可执行。

所属 Plugin `github-collaboration` `0.3.18`｜L1 658 B｜L2 23.7 KB｜L3 36.5 KB｜递归维护面 60.2 KB（占总维护面 17.4%）｜Agent 行为合同（维护／审查时读取）[`plugins/github-collaboration/skills/issue-workflow/SKILL.md`](../plugins/github-collaboration/skills/issue-workflow/SKILL.md)
所属 Plugin `adaptive-problem-solving` `0.2.12`｜L1 703 B｜L2 8.6 KB｜L3 123.4 KB｜递归维护面 132.0 KB（占总维护面 59.5%）｜Agent 行为合同（维护／审查时读取）[`plugins/adaptive-problem-solving/skills/adaptive-problem-solving/SKILL.md`](../plugins/adaptive-problem-solving/skills/adaptive-problem-solving/SKILL.md)

## orchestrated-collaboration

Expand All @@ -60,7 +42,7 @@ L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加

**什么会让它失效** 所选协调后端（当前 orca orchestration）的 Run／Task／Dispatch 语义或标准释放回执格式变化；或其唯一原则源 agent-control/authority/05-resource-operations.md 的资源投入原则变化，使 R1–R6 派发门失去依据。

所属 Plugin `orchestrated-collaboration` `0.2.6`｜L1 876 B｜L2 21.2 KB｜L3 28.9 KB｜递归维护面 50.1 KB（占总维护面 14.5%）｜Agent 行为合同（维护／审查时读取）[`plugins/orchestrated-collaboration/skills/orchestrated-collaboration/SKILL.md`](../plugins/orchestrated-collaboration/skills/orchestrated-collaboration/SKILL.md)
所属 Plugin `orchestrated-collaboration` `0.2.7`｜L1 876 B｜L2 21.3 KB｜L3 28.9 KB｜递归维护面 50.2 KB（占总维护面 22.6%）｜Agent 行为合同（维护／审查时读取）[`plugins/orchestrated-collaboration/skills/orchestrated-collaboration/SKILL.md`](../plugins/orchestrated-collaboration/skills/orchestrated-collaboration/SKILL.md)

## self-improvement

Expand All @@ -72,55 +54,7 @@ L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加

**什么会让它失效** 入口、Skill、任务记录三个改进承载面之一消失或职责变更，使路由判据指向不存在的去向。

所属 Plugin `self-improvement` `0.1.7`｜L1 673 B｜L2 8.8 KB｜L3 7.2 KB｜递归维护面 16.0 KB（占总维护面 4.6%）｜Agent 行为合同（维护／审查时读取）[`plugins/self-improvement/skills/self-improvement/SKILL.md`](../plugins/self-improvement/skills/self-improvement/SKILL.md)

## pr-integration

**它替你做什么** 分支维护与合并前核对，防止把冲突或落后的分支合进主干。

**什么时候用** 要合并，或分支落后于主干时。

**你怎么知道它在起作用** 合并前有冲突逐项处理与相称验证，合并后只做 fast-forward。

**什么会让它失效** 分支保护、合并策略或 force-push 的 lease 保护语义变化，使正文的分支维护步骤不再安全。

所属 Plugin `github-collaboration` `0.3.18`｜L1 581 B｜L2 15.6 KB｜L3 0.0 KB｜递归维护面 15.6 KB（占总维护面 4.5%）｜Agent 行为合同（维护／审查时读取）[`plugins/github-collaboration/skills/pr-integration/SKILL.md`](../plugins/github-collaboration/skills/pr-integration/SKILL.md)

## issue-delivery

**它替你做什么** 叶子 Issue 出 PR 前的工程检查与 PR 现状快照，避免拿没跑过的东西当交付。

**什么时候用** 手上的叶子 Issue 要出 PR 时。

**你怎么知道它在起作用** PR 描述里有覆盖维度、实际运行了什么、以及剩余验证缺口。

**什么会让它失效** PR 创建、审阅请求或必需检查的语义变化，使交付前核对无法只从远端事实判定。

所属 Plugin `github-collaboration` `0.3.18`｜L1 554 B｜L2 15.2 KB｜L3 0.0 KB｜递归维护面 15.2 KB（占总维护面 4.4%）｜Agent 行为合同（维护／审查时读取）[`plugins/github-collaboration/skills/issue-delivery/SKILL.md`](../plugins/github-collaboration/skills/issue-delivery/SKILL.md)

## objective-to-issues

**它替你做什么** 新建 Issue 一次到位：七类前缀、类型与领域标签、父级、运营台条目同批完成。

**什么时候用** 要新建 Issue 时。

**你怎么知道它在起作用** 新 Issue 建出来就带类型、领域、父级和运营台条目，不需要事后补。

**什么会让它失效** 七类标题前缀闭集、两个 label 维度或经营总账 Project 的字段定义被负责人修改，使创建骨架的硬校验与实际仓库不符。

所属 Plugin `github-collaboration` `0.3.18`｜L1 491 B｜L2 13.0 KB｜L3 0.0 KB｜递归维护面 13.0 KB（占总维护面 3.8%）｜Agent 行为合同（维护／审查时读取）[`plugins/github-collaboration/skills/objective-to-issues/SKILL.md`](../plugins/github-collaboration/skills/objective-to-issues/SKILL.md)

## operating-ledger-maintenance

**它替你做什么** 维护经营总账，把诉求、候选、决定、交付与证据分开记，不混成一锅。

**什么时候用** 出现值得跨 Session 保留的诉求、决定或证据变化时；或你要看总账时。

**你怎么知道它在起作用** 总账上诉求状态、执行状态与证据等级三者分开，不互相冒充。

**什么会让它失效** agent-control/authority/10-operating-ledger.md 的事项结构或状态分级变化，使维护动作指向不存在的字段。

所属 Plugin `github-collaboration` `0.3.18`｜L1 749 B｜L2 11.5 KB｜L3 0.0 KB｜递归维护面 11.5 KB（占总维护面 3.3%）｜Agent 行为合同（维护／审查时读取）[`plugins/github-collaboration/skills/operating-ledger-maintenance/SKILL.md`](../plugins/github-collaboration/skills/operating-ledger-maintenance/SKILL.md)
所属 Plugin `self-improvement` `0.1.7`｜L1 673 B｜L2 8.8 KB｜L3 7.2 KB｜递归维护面 16.0 KB（占总维护面 7.2%）｜Agent 行为合同（维护／审查时读取）[`plugins/self-improvement/skills/self-improvement/SKILL.md`](../plugins/self-improvement/skills/self-improvement/SKILL.md)

## resource-observability

Expand All @@ -132,19 +66,7 @@ L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加

**什么会让它失效** orca account list --json 的返回结构变化：顶层 ok、result.rateLimits.claude／codex 的 status 与 updatedAt，或 usedPercent／windowMinutes／resetsAt／rateLimitResetCredits 这些窗口字段不再按 Skill 正文描述提供。

所属 Plugin `resource-observability` `0.2.4`｜L1 608 B｜L2 5.6 KB｜L3 4.1 KB｜递归维护面 9.7 KB（占总维护面 2.8%）｜Agent 行为合同（维护／审查时读取）[`plugins/resource-observability/skills/resource-observability/SKILL.md`](../plugins/resource-observability/skills/resource-observability/SKILL.md)

## issue-contract-compaction

**它替你做什么** 把长 Issue 压成能恢复的合同，不丢授权、状态与未收口关系。

**什么时候用** Issue 评论长到影响新 Session 恢复时。

**你怎么知道它在起作用** 恢复的 Session 读到的是压缩后的合同，而不是从头读全部历史。

**什么会让它失效** GitHub 返回的时间标量精度或字段序列化形态变化，使「优先比较原始序列化标量」不再能区分真实变更。

所属 Plugin `github-collaboration` `0.3.18`｜L1 481 B｜L2 8.6 KB｜L3 0.0 KB｜递归维护面 8.6 KB（占总维护面 2.5%）｜Agent 行为合同（维护／审查时读取）[`plugins/github-collaboration/skills/issue-contract-compaction/SKILL.md`](../plugins/github-collaboration/skills/issue-contract-compaction/SKILL.md)
所属 Plugin `resource-observability` `0.2.4`｜L1 608 B｜L2 5.6 KB｜L3 4.1 KB｜递归维护面 9.7 KB（占总维护面 4.4%）｜Agent 行为合同（维护／审查时读取）[`plugins/resource-observability/skills/resource-observability/SKILL.md`](../plugins/resource-observability/skills/resource-observability/SKILL.md)

## knowledge-maintenance

Expand All @@ -156,7 +78,7 @@ L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加

**什么会让它失效** agent-control/authority/01-knowledge.md 的两道准入门或可信门八项条件发生变化。

所属 Plugin `knowledge-maintenance` `0.1.3`｜L1 644 B｜L2 6.3 KB｜L3 0.0 KB｜递归维护面 6.3 KB（占总维护面 1.8%）｜Agent 行为合同（维护／审查时读取）[`plugins/knowledge-maintenance/skills/knowledge-maintenance/SKILL.md`](../plugins/knowledge-maintenance/skills/knowledge-maintenance/SKILL.md)
所属 Plugin `knowledge-maintenance` `0.1.3`｜L1 644 B｜L2 6.3 KB｜L3 0.0 KB｜递归维护面 6.3 KB（占总维护面 2.9%）｜Agent 行为合同（维护／审查时读取）[`plugins/knowledge-maintenance/skills/knowledge-maintenance/SKILL.md`](../plugins/knowledge-maintenance/skills/knowledge-maintenance/SKILL.md)

## grilling

Expand All @@ -168,7 +90,7 @@ L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加

**什么会让它失效** 明示同意门被取消，或运行端改为按关键词自动进入长期盘问。

所属 Plugin `grilling` `0.1.2`｜L1 351 B｜L2 3.9 KB｜L3 0.0 KB｜递归维护面 3.9 KB（占总维护面 1.1%）｜Agent 行为合同（维护／审查时读取）[`plugins/grilling/skills/grilling/SKILL.md`](../plugins/grilling/skills/grilling/SKILL.md)
所属 Plugin `grilling` `0.1.2`｜L1 351 B｜L2 3.9 KB｜L3 0.0 KB｜递归维护面 3.9 KB（占总维护面 1.8%）｜Agent 行为合同（维护／审查时读取）[`plugins/grilling/skills/grilling/SKILL.md`](../plugins/grilling/skills/grilling/SKILL.md)

## skill-maintenance

Expand All @@ -180,4 +102,4 @@ L1 受每项 1000 UTF-8 字节可见性门约束；L2 只在选择 Skill 后加

**什么会让它失效** Skill 的发现入口、版本声明、复杂度预算、生成物或发布／退役工具发生变化，使正文盘点面和 clean cutover 步骤不再覆盖真实运行路径。

所属 Plugin `skill-maintenance` `0.1.0`｜L1 334 B｜L2 3.8 KB｜L3 0.0 KB｜递归维护面 3.8 KB（占总维护面 1.1%）｜Agent 行为合同（维护／审查时读取）[`plugins/skill-maintenance/skills/skill-maintenance/SKILL.md`](../plugins/skill-maintenance/skills/skill-maintenance/SKILL.md)
所属 Plugin `skill-maintenance` `0.1.0`｜L1 334 B｜L2 3.8 KB｜L3 0.0 KB｜递归维护面 3.8 KB（占总维护面 1.7%）｜Agent 行为合同（维护／审查时读取）[`plugins/skill-maintenance/skills/skill-maintenance/SKILL.md`](../plugins/skill-maintenance/skills/skill-maintenance/SKILL.md)
Loading