61 lines
3.0 KiB
Markdown
61 lines
3.0 KiB
Markdown
---
|
|
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 与通用工作流没有回归。
|