Octopus/octopus-workflow
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bb35e661b20b3048b724cebcecf275ebd42896a8
octopus-workflow/core/MIGRATION.md
T

137 lines
18 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Core 迁移映射表
编号保真（不变量 C-2）：迁移仅改位置，不改编号。映射登记的运行时事实源
是 `core/CORE-MANIFEST.json`；本表是批次级视图。
| 源路径 | Core 路径 | 批次 | 状态 |
| --------------------------------------------------------- | ----------------------------------------------------- | ---- | ---------------------------------------------------------------------------------------- |
| `.octopus/rules/claim-discipline.md` | `core/rules/claim-discipline.md` | G0 | 已迁移（逐字复制） |
| `.octopus/rules/stash-discipline.md` | `core/rules/stash-discipline.md` | G0 | 已迁移（逐字复制） |
| `.octopus/rules/code-graph.md` | `core/rules/code-graph.md` | G0 | 已迁移（逐字复制） |
| `.octopus/rules/compact.md` | `core/rules/compact.md` | G1 | 已迁移（接口中立化改写） |
| `.octopus/rules/workflow-routing.md` | `core/rules/workflow-routing.md` | G1 | 已迁移（接口中立化改写） |
| `.octopus/rules/auto-approve.md` | `core/rules/auto-approve.md` | G1 | 已迁移（接口中立化改写） |
| `.octopus/rules/two-tier-artifacts.md` | `core/rules/two-tier-artifacts.md` | G1 | 已迁移（接口中立化改写） |
| `.octopus/rules/ticket-lifecycle.md` | `core/rules/ticket-lifecycle.md` | G1 | 已迁移（接口中立化改写） |
| `.octopus/rules/testing.md` | `core/rules/testing.md` | G1 | 已迁移（接口中立化改写） |
| （Core 原生，无 dogfood 源） | `core/rules/artifact-addressing.md` | G2 | 新增（Core 原生契约） |
| `.octopus/skills/_shared/gitea-write-patterns.md` | `core/adapters/gitea/patterns.md` | G2 | 已拆分（adapter 拆分上提） |
| `.octopus/skills/_shared/gitea-read-patterns.md` | `core/adapters/gitea/reading.md` | G2 | 已拆分（adapter 拆分上提） |
| `.octopus/rules/issue-checklist-sync.md` | `core/rules/issue-checklist-sync.md` | G3 | 已迁移（接口中立化改写） |
| `.octopus/rules/issue-cross-linking.md` | `core/rules/issue-cross-linking.md` | G3 | 已迁移（接口中立化改写） |
| `.octopus/rules/artifact-index-guards.md` | `core/rules/artifact-index-guards.md` | G3 | 已迁移（接口中立化改写） |
| `.octopus/rules/type-checking.md` | `core/rules/type-checking.md` | G3 | 已迁移（接口中立化改写） |
| `.octopus/rules/session-scope-guard.md` | `core/rules/session-scope-guard.md` | G3 | 已迁移（接口中立化改写） |
| `.octopus/skills/analyze-dag/` | `core/skills/analyze-dag/` | G4 | 已迁移（整目录逐字） |
| `.octopus/skills/browser-debug/` | `core/skills/browser-debug/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/codegraph-setup/` | `core/skills/codegraph-setup/` | G4 | 已迁移（整目录逐字） |
| `.octopus/skills/frontend/` | `core/skills/frontend/` | G4 | 已迁移（整目录逐字） |
| `.octopus/skills/gitea-rest/` | `core/skills/gitea-rest/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/headless-session-ops/` | `core/skills/headless-session-ops/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/image-interpret/` | `core/skills/image-interpret/` | G4 | 已迁移（整目录逐字） |
| `.octopus/skills/implement/` | `core/skills/implement/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/land-batch/` | `core/skills/land-batch/` | G4 | 已迁移（整目录逐字） |
| `.octopus/skills/project-kickoff/` | `core/skills/project-kickoff/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/prototype/` | `core/skills/prototype/` | G4 | 已迁移（整目录逐字） |
| `.octopus/skills/release/` | `core/skills/release/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/retrospective/` | `core/skills/retrospective/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/review-artifact/` | `core/skills/review-artifact/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/review-code/` | `core/skills/review-code/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/verify/` | `core/skills/verify/` | G4 | 已迁移（整目录逐字；6a 改写为 rewritten） |
| `.octopus/skills/writing-skills/` | `core/skills/writing-skills/` | G4 | 已迁移（整目录逐字） |
| `.octopus/skills/_shared/compaction-round-boundary.md` | `core/skills/_shared/compaction-round-boundary.md` | G4 | 已迁移（逐字，protected 纪律载体；6a 改写为 rewritten） |
| `.octopus/skills/_shared/large-prompts.md` | `core/skills/_shared/large-prompts.md` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/review-final-report-template.md` | `core/skills/_shared/review-final-report-template.md` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/review-orchestrator-rules.md` | `core/skills/_shared/review-orchestrator-rules.md` | G4 | 已迁移（逐字；6a 改写为 rewritten） |
| `.octopus/skills/_shared/review-pipeline-phases.md` | `core/skills/_shared/review-pipeline-phases.md` | G4 | 已迁移（逐字，protected 纪律载体；6a 改写为 rewritten） |
| `.octopus/skills/_shared/review-reviewer-prompt.md` | `core/skills/_shared/review-reviewer-prompt.md` | G4 | 已迁移（逐字，protected 纪律载体；6a 改写为 rewritten） |
| `.octopus/skills/_shared/review-revision-prompt.md` | `core/skills/_shared/review-revision-prompt.md` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/synthesis_task.md` | `core/skills/_shared/synthesis_task.md` | G4 | 已迁移（逐字，protected 纪律载体；6a 改写为 rewritten） |
| `.octopus/skills/_shared/worker-report-persistence.md` | `core/skills/_shared/worker-report-persistence.md` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/roles/coordinator.yaml` | `core/skills/_shared/roles/coordinator.yaml` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/roles/producer.yaml` | `core/skills/_shared/roles/producer.yaml` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/roles/reviewer.yaml` | `core/skills/_shared/roles/reviewer.yaml` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/roles/tool.yaml` | `core/skills/_shared/roles/tool.yaml` | G4 | 已迁移（逐字） |
| `.octopus/skills/_shared/roles/verifier.yaml` | `core/skills/_shared/roles/verifier.yaml` | G4 | 已迁移（逐字） |
| `.octopus/checklists/*.md`（13 份） | `core/checklists/` | G4 | 已迁移（逐字；audit-process/bugfix/pipeline-gate/port/prototype/verification；6a 改写为 rewritten） |
| `.octopus/templates/*.md`（2 份） | `core/templates/` | G4 | 已迁移（逐字） |
| `.octopus/schemas/port-analysis.schema.json` | `core/schemas/port-analysis.schema.json` | G5 | 已迁移（$id 迁至公共命名空间） |
| `.octopus/schemas/review-status.schema.json` | `core/schemas/review-status.schema.json` | G5 | 已迁移（$id 迁至公共命名空间） |
| `.octopus/schemas/reviewer-output.schema.json` | `core/schemas/reviewer-output.schema.json` | G5 | 已迁移（$id 迁至公共命名空间） |
| `.octopus/schemas/runs-bundle.schema.json` | `core/schemas/runs-bundle.schema.json` | G5 | 已迁移（$id 迁至公共命名空间） |
| `.octopus/schemas/runs-index.schema.json` | `core/schemas/runs-index.schema.json` | G5 | 已迁移（$id 迁至公共命名空间；artifacts[].schema 声明历史接受集） |
| `.octopus/schemas/runs-meta.schema.json` | `core/schemas/runs-meta.schema.json` | G5 | 已迁移（$id 迁至公共命名空间） |
| `.octopus/schemas/synthesis.schema.json` | `core/schemas/synthesis.schema.json` | G5 | 已迁移（$id 迁至公共命名空间） |
| `.octopus/schemas/workflow-routing.schema.json` | `core/schemas/workflow-routing.schema.json` | G5 | 已迁移（$id 迁至公共命名空间） |
| （待登记） | （待登记） | G5+ | 未开始 |
## G5 twin 归一记录
scaffold-template 侧（`packages/octopus/src/cli/cmd/scaffold-template/schemas/`）
schema `$id` 的 owner token 归一（旧命名空间 owner token → Octopus，与既有 2 份多数对齐；
`normalizeSchemaOwnerToken` 归一化下双向等价，纯一致性清理）：
- `review-status.schema.json`
- `reviewer-output.schema.json`
- `runs-bundle.schema.json`
- `runs-index.schema.json`
- `synthesis.schema.json`
- `workflow-routing.schema.json`
## 保护注记（protected 纪律载体）
以下四个 `_shared` 文件是多轮评审管线的纪律载体（round-boundary 压缩、
评审提示词、综合任务），G4 仅逐字迁移不改内容；其改写留给 Increment 6
（deferHard 标记已在 manifest 登记）：
- `review-pipeline-phases.md`
- `review-reviewer-prompt.md`
- `synthesis_task.md`
- `compaction-round-boundary.md`
## G6（Increment 6a：发布单元达标面）
- **deferHard 27 件 → rewritten**：10 个 verbatimDir 技能目录 + 17 个
verbatim 文件（_shared md/yaml + 清单/模板）全部按 G1 风格中立化改写
（机制/结构/frontmatter 保留；实例术语以占位符表述并指向
core/adapters/TERMINOLOGY.md；技能内 .ts 脚本未动）。gitea-rest SKILL.md
标注为 gitea adapter reference implementation（frontmatter 原样）。
manifest：sync → rewritten（目录行保持目录路径）、batch → G6、deferHard
键全删。
- **守卫小扩展**：parity/cohesion/dangling/core-sync 支持 rewritten 目录行
（存在性 = 目录存在；C-1 扫描 = 递归目录内 .md/.yaml）；cohesion 默认
扫描面纳入 .yaml；core-sync 对 rewritten 目录行报 managed-by 跳过。
- **去链接化契约执行**：core/** 全树 #NNNN 活引用 → [org-internal #NNNN]
注记（457 处、48 文件）；delink:core 幂等；verbatim 镜像内 60 处递延
至 6b。
- **examples/ 建立**：4 篇组织沉积教学案例（sprint-mode 吞吐事故、
preflight 证据闭环、WIP cap 与 TD 登记、评审轮次预算），只引用 Core
不被引用。
- **P1 终验门**：check:core-p1（98 文本文件全树扫描；豁免 id-aliases.json
与 runs-index 历史命名空间声明；verbatim 镜像 2 处命中列 6b 递延）。
- 最终分类：71 mappings = 15 verbatim + 7 verbatimDir + 46 rewritten +
2 split + 1 core-only。
## G6b（Increment 6b：字节锁解锁 + EMBED 重指）
- **字节锁镜像翻转 rewritten**：v3 去链接化契约规定 dogfood 侧保留活链接
→ 不能三侧同批 delink。18 个携带 refs/P1 命中的 verbatim/verbatimDir
镜像（13 个 verbatim 文件行 + 5 个 verbatimDir 目录行）翻转为
sync = "rewritten"、batch = "G6b"；core 侧运行 delink（60 处
#NNNN → [org-internal #NNNN]）+ 两处旧 owner legacy-token 手工中立化
（checklists/code-review.md 5.8 行、checklists/refactoring.md 4.7 行，
改为不指名组织的 token 漂移表述）；dogfood 侧不动（parity 的 rewritten
语义 = 双侧存在 + core 模式扫描，无字节比较）。翻转账本的 md 链接改写
为 core/ 与 <instance-root>/ 引用形态（analyze-dag/frontend/
writing-skills 共 21 处路径去实例化）。
- **EMBED 重指 core/**：generate-builtin.ts 的 EMBED_SOURCES 源权威从
`<instance-root>/` 改为 core/（audit §G 承诺）。CLOSURE_PATTERN / META_SKILL_
PREFIXES / closure 路径解析同步重指；service 键名（rules/auto-approve.md
等）保持不变，运行时读取不受影响。builtin overlay 仅在无 <instance-root>/
磁盘目录时生效——本组织恒有 → dogfood 运行时不变；shipped 默认语料自此
为中立版（内嵌 [org-internal #NNNN] 注记、无组织实例 token）。
- **终验归零**：delink-core --check 0 replaceable / 0 deferred；
check-core-p1 0 hits / 0 deferred（6a 递延清单全部清偿）。
- 最终分类：71 mappings = 2 verbatim + 2 verbatimDir + 64 rewritten +
2 split + 1 core-only。
Reference in New Issue View Git Blame Copy Permalink