refactor(releaser): 将 manage-release 改名为 releaser
- skills/manage-release -> skills/releaser(git mv,内容不变) - releaser 的 frontmatter/标题改名,description 保留旧名作为触发词 - skills/manage-release/ 保留为纯弃用占位(SKILL.md + README.md,指向 releaser), 已装软链与旧项目 .pouch.yaml 不再悬空或失效 - 同步或引用:AGENTS.md、README.md、docs/getting-started.md、orc(routing/SKILL/README)、 ack delivery、builder(SKILL/README/contract)、memory-distill、pouch onboard 与 suggest_skills - 测试:catalog 需列出旧名占位,新增弃用占位断言,orc children 纳入旧名占位
This commit is contained in:
@@ -18,12 +18,12 @@ pouch add orc # 当前项目
|
||||
pouch add orc -g # 全局
|
||||
```
|
||||
|
||||
`$orc` / `/orc` 只在显式调用时运行。下游阶段还需要已安装 `$ack`、`$manage-release` 或 `$builder`。
|
||||
`$orc` / `/orc` 只在显式调用时运行。下游阶段还需要已安装 `$ack`、`$releaser` 或 `$builder`。
|
||||
|
||||
## 使用前准备
|
||||
|
||||
- Orca 正在运行并启用了 orchestration。
|
||||
- 安装本次需要的 `$ack`、`$manage-release` 或 `$builder`(DEB 与 Docker 共用)。
|
||||
- 安装本次需要的 `$ack`、`$releaser` 或 `$builder`(DEB 与 Docker 共用)。
|
||||
- ORC 直接使用 skill 内共享的 `config.yaml`,不需要在每个项目初始化配置。修改这份
|
||||
配置会影响所有项目;旧的项目级 `docs/orc/config.yaml` 不再参与解析。
|
||||
- `/usr/bin/python3`;ORC v2 配置必须保持为 JSON-compatible YAML。
|
||||
|
||||
+4
-4
@@ -73,7 +73,7 @@ JSON-compatible YAML,并由隔离的 Python 标准库解析。它固定包含
|
||||
`cursor-agent`。身份不明确时停止,不从用户任务文本、默认值或已安装 executable 猜测。
|
||||
确认宿主 CLI 可用;在 Cursor 中还要用 `cursor-agent --list-models`
|
||||
核对精确模型 ID 对当前账号可见。
|
||||
4. 确认本次所需下游 Skill 已安装:`ack`、`manage-release`、`builder`。只检查实际
|
||||
4. 确认本次所需下游 Skill 已安装:`ack`、`releaser`、`builder`。只检查实际
|
||||
会用到的项;`deb` 与 `docker` 阶段都由 `$builder` 承载。
|
||||
5. 解析 profile 时把项目根和目标 worktree 一并交给 resolver;只有 resolver 验证目标是
|
||||
当前 Git 仓库已注册的 worktree 且身份稳定后才可创建终端。不得只做文本比较或跳过
|
||||
@@ -100,7 +100,7 @@ JSON-compatible YAML,并由隔离的 Python 标准库解析。它固定包含
|
||||
`codex-login`,Cursor 默认复用 `cursor-login`;只有明确使用环境凭据时才分别选择
|
||||
`openai`、`azure-openai` 或 `cursor-api-key`。远端认证默认 `none`。release worker 作为
|
||||
受信任发布角色,直接调用当前 shell 中已认证的 `git` 与 Forge CLI;Gitea/Forgejo 由
|
||||
`$manage-release` 在目标 worktree 中运行 `tea`,resolver 不读取 tea 配置、不注入
|
||||
`$releaser` 在目标 worktree 中运行 `tea`,resolver 不读取 tea 配置、不注入
|
||||
credential helper,也不把 tea token 转成环境变量。只有明确改用环境 token 或 SSH
|
||||
agent 时,才选择一个精确的 `github-token`、`gitlab-token`、`gitea-token`、
|
||||
`forgejo-token`、`ssh-agent` 或 `deb-token`,不得同时交给 worker 多组环境凭据。resolver
|
||||
@@ -131,7 +131,7 @@ JSON-compatible YAML,并由隔离的 Python 标准库解析。它固定包含
|
||||
|
||||
- 功能、缺陷、重构与验证闭环交给 `$ack`。
|
||||
- 发布版本、release 分支/PR/MR、合并、tag 与 Forge Release 交给
|
||||
`$manage-release`。
|
||||
`$releaser`。
|
||||
- DEB 构建或上传交给 `$builder`(deb 阶段);Docker/OCI 镜像构建或上传也交给
|
||||
`$builder`(docker 阶段)。
|
||||
- 普通非发布 PR/MR 不伪装成版本发布;只有 ACK 已验证交付或明确的 release 流程才
|
||||
@@ -165,7 +165,7 @@ JSON-compatible YAML,并由隔离的 Python 标准库解析。它固定包含
|
||||
- resolver 只读取 skill 内有大小上限的普通共享配置文件,拒绝 symlink/special file;
|
||||
启动计划绑定配置快照、root-owned 隔离 Python、可信绝对 Agent/Orca executable、Git
|
||||
worktree identity、release remote identity、精确环境认证选择和固定 argv。实际启动会
|
||||
重新校验 fingerprint;release 阶段允许受信任的 `$manage-release` 直接使用当前 shell
|
||||
重新校验 fingerprint;release 阶段允许受信任的 `$releaser` 直接使用当前 shell
|
||||
已有的 Git/Forge 登录,resolver 不检查或复制认证文件。显式 token/SSH 认证仍只注入所选
|
||||
环境变量。不得改写 resolver 返回的 worker argv,也不得把终端创建 argv 的绝对 Orca
|
||||
路径换成项目 `PATH` 解析。
|
||||
|
||||
@@ -8,7 +8,7 @@ ORC 是薄路由器,只负责意图映射、依赖、静态档位和结构化
|
||||
| 阶段 | 下游 Skill | 包含 | 不包含 |
|
||||
|------|------------|------|--------|
|
||||
| `code` | `$ack` | 功能、缺陷、重构、测试、三角色验证闭环,以及用户明确要求的普通非发布 PR/MR | 版本发布、单独上传产物 |
|
||||
| `release` | `$manage-release` | 版本号、release worktree/分支、release PR/MR、合并、tag、Forge Release、恢复发布 | 普通非发布 PR/MR、构建或上传 DEB/Docker |
|
||||
| `release` | `$releaser` | 版本号、release worktree/分支、release PR/MR、合并、tag、Forge Release、恢复发布 | 普通非发布 PR/MR、构建或上传 DEB/Docker |
|
||||
| `deb` | `$builder` | DEB 构建、契约校验、上传与仓库可见性 | 源码 tag、Docker 镜像 |
|
||||
| `docker` | `$builder` | Docker/OCI 构建、push、digest 与平台验证 | 源码版本生命周期、DEB |
|
||||
|
||||
@@ -26,7 +26,7 @@ decision gate。不得为了填满 worker prompt 而分析代码、推断版本
|
||||
2. 为每个阶段锁定输入:项目、worktree、源 commit/tag、版本、目标和用户授权的最远
|
||||
写操作。
|
||||
3. 同一领域的连续动作保留在一个下游任务中。例如版本号、release PR、合并和 tag
|
||||
属于一个 `manage-release` 生命周期,不拆成多个互相争抢状态的 worker。
|
||||
属于一个 `releaser` 生命周期,不拆成多个互相争抢状态的 worker。
|
||||
4. 只有输入 revision 完全相同且互不修改同一工作树时,才并行执行 DEB 与 Docker。
|
||||
5. 普通代码改动进入 ACK。若项目尚未初始化 ACK,`code` 阶段停在前置条件,不由 ORC
|
||||
静默初始化。
|
||||
@@ -39,7 +39,7 @@ decision gate。不得为了填满 worker prompt 而分析代码、推断版本
|
||||
|
||||
```text
|
||||
code ($ack)
|
||||
-> release ($manage-release)
|
||||
-> release ($releaser)
|
||||
-> deb ($builder)
|
||||
-> docker ($builder)
|
||||
```
|
||||
@@ -53,10 +53,10 @@ deb ($builder) || docker ($builder)
|
||||
仅发布源码版本:
|
||||
|
||||
```text
|
||||
release ($manage-release)
|
||||
release ($releaser)
|
||||
```
|
||||
|
||||
依赖不是固定模板,但 ORC v2 不拆分一个 `manage-release` 生命周期。若项目要求在打开
|
||||
依赖不是固定模板,但 ORC v2 不拆分一个 `releaser` 生命周期。若项目要求在打开
|
||||
release PR 与合并之间插入 DEB/Docker gate,当前 task 粒度无法安全表达该中间里程碑;
|
||||
在打开 PR 前建立 decision gate 并报告该流程暂不支持,不得用循环依赖或两个 release
|
||||
worker 临时拼接。
|
||||
@@ -65,7 +65,7 @@ worker 临时拼接。
|
||||
|
||||
每个 worker prompt 至少包含:
|
||||
|
||||
- 第一条指令显式调用唯一的下游 Skill,例如 `Use $manage-release ...`。
|
||||
- 第一条指令显式调用唯一的下游 Skill,例如 `Use $releaser ...`。
|
||||
- 阶段目标与明确的非目标。
|
||||
- 项目/worktree、输入 commit/tag 和前置阶段的可核对结果。
|
||||
- 用户已经授予的最远动作;未授权动作明确禁止。
|
||||
|
||||
Reference in New Issue
Block a user