feat(marketplace): 注册多语言技术插件

This commit is contained in:
zhiye.sun
2026-09-03 17:14:07 +08:00
parent 5e465faa7b
commit dd6071e81f
3 changed files with 58 additions and 4 deletions
+36
View File
@@ -63,6 +63,42 @@
"authentication": "ON_INSTALL"
},
"category": "Productivity"
},
{
"name": "profile",
"source": {
"source": "local",
"path": "./plugins/profile"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Productivity"
},
{
"name": "java",
"source": {
"source": "local",
"path": "./plugins/java"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Productivity"
},
{
"name": "python",
"source": {
"source": "local",
"path": "./plugins/python"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Productivity"
}
]
}
+6 -2
View File
@@ -13,14 +13,15 @@
- `knowledge:document-output` 增加 `register` 与 `close` 模式,使用 `workRoot/<task>/task.json` 记录任务状态、文件归属、可见性和关闭处置。
- 增加“保留、沉淀、归档、删除、延后”五类关闭清单,以及共享文件逐项评审、断链检查和精确路径删除门禁。
- 增加长期文档 `pending`、`approved`、`outdated` 审核状态,以及项目级文档持续维护规范。
- 增加 `profile`、`java` 和 `python` 插件骨架,以统一契约提供多语言技术能力。
- 增加 Profile manifest、版本范围、能力状态、引用安全规则和标准库校验器。
- 增加 `python:review-python`,按项目版本审查类型、异常、资源、异步、事务和测试隔离问题。
### Planned
- 建设 Skill 评测基线,支持固定场景、验收规则和更新前后回归比较。
- 保持 `dev` 插件的通用设计、实现、测试和审查核心,不按 Java、Python、React 或 Vue 复制整套工作流;仅当专项能力具备独立安装、发布或维护需求时再评估拆分插件。
- 补充 Python 专项支持,优先增加 `review-python`,并为现有后端实现与测试 Skill 建立 Python 版本、`pyproject.toml`、pytest、Ruff、mypy/pyright 及 FastAPI、Django、Flask 的按需资料路由。
- 补充前端工程质量专项支持,增加 `test-frontend` 和 `review-typescript`,分别覆盖单元、组件与集成测试,以及 TypeScript 类型安全与模块契约。
- 建立按项目真实依赖选择的语言与框架 profile,优先覆盖 Java、Python、React、Vue、Next.js、Nuxt 及相关构建、状态和测试工具;未确认精确版本时不默认最新版本,不跨版本混用规则。
- 增加命令环境探测与指令适配辅助 Skill:识别操作系统、Shell/终端类型及版本、Codex 可用功能工具、命令行工具来源与版本,生成当前任务的环境能力快照,并按探测结果选择经过验证的默认指令;覆盖 PowerShell、Windows PowerShell、CMD、Bash、Zsh 等环境中的路径、引号、转义、编码、管道、退出码和标准输出/错误流差异。
- 为 Git 建立版本与仓库状态 profile:根据 Git 版本选择 `checkout`、`switch`、`restore`、Worktree、分支跟踪和安全目录等命令形式,固定参数顺序并兼容含空格或非 ASCII 字符的路径与引用;复合操作按步骤检查退出码,区分“无输出的正常状态”、部分成功和真正失败,避免前置 `fetch` 失败后继续使用陈旧远端引用,也避免后置只读检查的非零退出码掩盖已经成功的写操作。
- 为 Maven、JDK 和项目构建工具建立版本 profile:优先识别 Maven Wrapper、Maven/JDK 实际版本、`JAVA_HOME`、Toolchains、父 POM、模块结构、激活 profile、`settings.xml` 入口及仓库镜像,再选择全量或 `-pl`/`-am` 等聚焦构建命令;将 Maven 版本不兼容、JDK 不匹配、插件或父 POM 无法解析、缓存问题、编译失败和测试失败分类处理,不用重复执行同一命令代替诊断。
@@ -35,6 +36,9 @@
- 需求与设计 Skill 优先更新已有权威文档;实现、升级和代码审核流程检查留存文档是否因代码或契约变化而需要同步。
- `task.json` 使用 `created`、`updated`、`referenced` 区分任务关系,关联旧文档不转移所有权,也不产生删除权限。
- README 的 Skill 说明同步覆盖文档创建、审核、持续更新、历史归档和关闭职责。
- `design-backend`、`implement-backend`、`test-backend` 和 `review-java` 接入可选语言 Profile,并在提供方缺失时保留通用回退。
- 项目画像模板升级到 Schema 2,保留顶层兼容概要并支持模块级技术栈;插件安装状态不写入共享画像。
- 多语言架构文档收敛为单一设计依据和阶段跟踪计划,并记录 Codex 当前没有 Skill 运行时依赖接口的约束。
## [1.3.0] - 2026-08-31
+16 -2
View File
@@ -28,6 +28,9 @@ CraftKit 按“初始化约定 → 创建或更新 → 审核生效 → 随实
| `git` | 分支、提交、变更提取、集成与发布准备 |
| `knowledge` | 项目初始化、任务交接、问题复盘与经验维护 |
| `skill` | 项目规范检索、维护与 Skill 辅助工具 |
| `profile` | 多语言技术能力契约、匹配规则与静态校验 |
| `java` | Java、构建工具与 Spring 技术能力资料 |
| `python` | Python、包管理、FastAPI、测试与专项审查资料 |
## Skill 介绍
@@ -111,6 +114,14 @@ CraftKit 按“初始化约定 → 创建或更新 → 审核生效 → 随实
| `guidance` | 检索当前有效的项目规则和知识,区分待审核、过时与历史材料。 |
| `guidance-edit` | 建立、检查和维护 `.craftkit/standards/` 规范索引。 |
### Profile、Java 与 Python
- `profile:resolve`:根据目标模块、项目事实和当前会话已发现的提供方解析技术能力;缺失时返回明确回退。
- `java:profile`:提供 Java、Maven/Gradle、Spring 设计、命令和审查资料。
- `python:profile`:提供 Python、包管理、FastAPI、实现、测试和审查资料。
- `python:review-python`:按项目版本专项审查 Python 类型、异常、资源、异步、事务和测试隔离问题。
跨插件逻辑标识只用于诊断。各提供方读取自身资料,核心 Skill 不扫描用户插件缓存;项目规范仍由 `guidance` 合并。
## 目录结构
```text
@@ -130,7 +141,10 @@ CraftKit/
│ ├─ doc/
│ ├─ git/
│ ├─ knowledge/
│ └─ skill/
│ ├─ skill/
│ ├─ profile/
│ ├─ java/
│ └─ python/
└─ README.md
```
@@ -144,6 +158,6 @@ CraftKit/
## 本地使用
本仓库提供仓库级 marketplace。将仓库注册为本地 marketplace 后,可按需安装 `dev`、`doc`、`git`、`knowledge` 或 `skill` 插件。
本仓库提供仓库级 marketplace。将仓库注册为本地 marketplace 后,可按需安装 `dev`、`doc`、`git`、`knowledge`、`skill`、`profile`、`java` 或 `python` 插件。
正式公开发布前,还需补充许可证、公开仓库地址、作者信息、隐私政策和市场素材。