---
reviewStatus: pending
reviewedAt: null
replacedBy: null
---

# 多语言插件架构改造计划

## 1. 文档职责

本文只跟踪多语言插件架构的实施批次、前置依赖、验证门禁和完成状态。架构、契约、项目画像及运行机制以[《多语言插件架构设计与实施方案》](MULTI-LANGUAGE-PLUGIN-ARCHITECTURE-DESIGN.md)为唯一依据。

详细执行记录位于 `.craftkit/local/tasks/multi-language-plugin/`，不在本文复制过程步骤。

## 2. 当前决策

- 首期建立 `profile`、`java` 和 `python` 独立插件骨架，但在安装组合通过前不声明可独立交付。
- Profile 插件维护静态契约、匹配规则和校验器，不扫描插件缓存，也不把 Skill 协作描述为函数调用。
- 消费者从当前会话已发现的提供方 Skill 获取专项能力；提供方缺失时执行通用回退。
- `knowledge:init` 是项目画像的唯一写入者，`guidance` 是项目规则与公共规则的合并入口。
- Schema 2 先由消费者双读，再由初始化入口写入。
- 插件安装状态不进入共享项目画像。

## 3. 实施批次

| 批次 | 目标 | 前置依赖 | 核心产物 | 状态 |
| --- | --- | --- | --- | --- |
| P0 | 收敛文档并验证平台机制 | 无 | 架构决策、最小插件骨架、验证记录 | 已完成（运行时验证转 P6） |
| P1 | 建立 Profile 静态契约 | P0 | JSON Schema、解析规则、校验器 | 已完成 |
| P2 | 建立 Java/Python 最小提供方 | P1 | 双提供方 manifest 和专项资料 | 已完成静态实现 |
| P3 | 接入首个核心消费者 | P2 | `design-backend` 双语言路由 | 已完成实现，待新会话验证 |
| P4 | 建立 Schema 1/2 双读 | P3 | 模块级画像、迁移与回滚规则 | 已完成实现 |
| P5 | 逐个接入核心消费者 | P4 | 设计、实现、测试、审查闭环 | 已完成实现，待新会话验证 |
| P6 | 验证独立安装和发布 | P5 | 安装矩阵、兼容矩阵、发布材料 | 部分完成，运行时验证待处理 |
| P7 | 按需求扩展框架和前端 | P6 | 可独立验证的增量能力 | 待执行 |

## 4. 阶段门禁

每个批次必须分别记录：

1. 实际修改范围。
2. 静态校验结果。
3. 真实或最小可运行场景验证结果。
4. 未验证边界。
5. 停止条件检查。
6. 是否允许进入下一批次。

静态清单或脚本校验通过不代表 Codex 运行时行为已经验证。跨插件发现、Skill 激活和缺失回退必须在安装后的新会话中验证。

## 5. 总体验收

- Java 与 Python 提供方遵循同一契约。
- 核心 Skill 不复制语言专属工作流。
- Schema 1 和 Schema 2 均可读取。
- 多模块仓库按目标路径解析技术栈。
- 缺少提供方、版本未知和版本不兼容都有确定回退。
- 项目规范覆盖公共 Profile 时保留双方来源。
- Spring Boot 和 FastAPI 完成同一请求的端到端对照。
- 核心、Profile、Java 和 Python 的安装组合全部验证。
- 现有 Java 与通用工作流没有回归。