feat(dev): 接入多语言 Profile 能力路由

2026-09-03 17:12:54 +08:00
parent 199a14daea
commit 018bc2e914
6 changed files with 34 additions and 16 deletions
@@ -1,6 +1,6 @@
 {
  "name": "dev",
-  "version": "0.5.0",
+  "version": "0.6.0",
  "description": "通用软件设计、编码、审查与测试工作流。",
  "author": {
    "name": "CraftKit"
@@ -10,17 +10,21 @@ description: 基于需求、现有后端代码和项目规范设计模块边界
 ## 工作流

 1. 读取需求、项目元数据、适用规范、依赖清单和相关后端实现，确认语言、框架及精确版本。
-2. 按 [范围分析](references/scope.md) 明确现状、边界、参与者和约束。
-3. 设计模块职责、调用关系、数据所有权、事务边界、并发策略、错误语义、权限和可观测性。
-4. 数据库或 HTTP 契约需要详细设计时，记录输入和待决项，交由相应专项 Skill；本 Skill 保持整体一致性。
-5. 按 [设计输出](references/output.md) 展示方案、备选项和风险，并用 [评审清单](references/review.md) 自检。
-6. 默认在对话中输出；用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`，并保守写入。
+2. 按 [Profile 消费规则](references/profile-consumption.md) 确定目标模块和 `backend-design` 能力；提供方缺失时继续使用中性流程并报告缺口。
+3. 按 [范围分析](references/scope.md) 明确现状、边界、参与者和约束。
+4. 设计模块职责、调用关系、数据所有权、事务边界、并发策略、错误语义、权限和可观测性。
+5. 数据库或 HTTP 契约需要详细设计时，记录输入和待决项，交由相应专项 Skill；本 Skill 保持整体一致性。
+6. 按 [设计输出](references/output.md) 展示方案、备选项和风险，并用 [评审清单](references/review.md) 自检。
+7. 默认在对话中输出；用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`，并保守写入。

-落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot/<task>/task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。
+落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。
+
+写入后在 `workRoot/<task>/task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。

 ## 边界

 - 已安装 `guidance` 时用它获取项目规则；未安装时按“目标目录适用的 `AGENTS.md` → `.craftkit/agents/index.md` → `.craftkit/standards/index.md` → 命中正文”的顺序手工读取。不存在的规范、框架能力和依赖接口不得猜测。
 - 版本从 `.craftkit/project.json`、构建文件、锁文件或源码证据确认，不默认最新版本。
+- 当前会话没有发现语言提供方时，不扫描插件缓存或猜测物理路径。
 - 对现有系统的设计先追踪真实调用链和数据流，区分已验证事实与建议。
 - 不把接口示例、表结构草案或伪代码视为已实施行为。
@@ -0,0 +1,10 @@
+# Profile 消费规则
+
+1. 使用目标路径匹配项目画像中的模块；Schema 1 或没有模块时，将顶层技术栈作为根模块候选。
+2. 从项目画像、构建文件和锁文件确认语言、框架及精确版本。
+3. 当前会话发现对应语言的 Profile Skill 时，请求 `backend-design` 能力，由提供方读取自身资料。
+4. 没有发现提供方时，将能力标记为 `missing`，继续执行中性后端设计流程。
+5. Profile 逻辑资料标识只用于诊断，不转换为用户插件缓存路径。
+6. 项目规则由 `guidance` 合并；Profile 只提供公共技术资料。
+
+输出中报告目标模块、版本证据、提供方、能力状态、项目覆盖和未覆盖范围。版本不匹配时不得加载冲突资料。
@@ -11,10 +11,11 @@ description: 按当前项目真实语言、框架版本、规范和现有实现

 1. 检查 Git 状态，保留用户已有改动；确认目标、范围和不可修改项。
 2. 读取 `AGENTS.md`、`.craftkit/project.json`，从构建文件确认真实版本。已安装 `guidance` 时用它检索规范；未安装时按“目标目录适用的 `AGENTS.md` → `.craftkit/agents/index.md` → `.craftkit/standards/index.md` → 命中正文”的顺序手工读取，不因缺少另一插件中断实现。
-3. 追踪入口、调用链、数据流、测试和相邻稳定实现；检索相关需求、设计、规范和知识，设计不足时先补最小决策，不套用固定模板。
-4. 实施最小完整变更，保持项目目录、依赖、异常、事务、日志和测试风格。
-5. 检查本次接口、数据模型、业务行为和验证结论是否使长期文档过期；更新受影响的权威文档并登记到当前 `task.json`，不能完成时标为 `outdated` 并列入待办。
-6. 执行项目已有的编译、静态检查和相关测试，分别报告未执行的真实环境验证。
+3. 按目标模块请求 `backend-implementation` 和 `command-resolution`；当前会话未发现语言提供方时继续使用通用实现流程并报告缺口，不扫描插件缓存。
+4. 追踪入口、调用链、数据流、测试和相邻稳定实现；检索相关需求、设计、规范和知识，设计不足时先补最小决策，不套用固定模板。
+5. 实施最小完整变更，保持项目目录、依赖、异常、事务、日志和测试风格。
+6. 检查本次接口、数据模型、业务行为和验证结论是否使长期文档过期；更新受影响的权威文档并登记到当前 `task.json`，不能完成时标为 `outdated` 并列入待办。
+7. 执行项目已有的编译、静态检查和相关测试，分别报告未执行的真实环境验证。

 ## 安全边界

@@ -10,7 +10,8 @@ description: 按项目 Java 版本、框架、规范和真实调用上下文评
 ## 工作流

 1. 确认审查范围、版本、框架、编译选项和相关测试。
-2. 检查类型与空值、异常边界、资源关闭、集合、并发、序列化和公开契约。
-3. 语言结论按 [官方来源](references/sources.md) 路由到当前版本；预览特性不得视为默认可用。
-4. 只报告可复现、有代码证据且影响明确的问题，按严重度给出最小修复建议。
-5. 未运行编译或测试时明确说明，不自动修改代码。
+2. 当前会话发现 `java:profile` 时请求 `language-review`，由提供方读取自身资料；未发现时继续使用本 Skill 的最小基线并报告缺口。
+3. 检查类型与空值、异常边界、资源关闭、集合、并发、序列化和公开契约。
+4. 语言结论按 [官方来源](references/sources.md) 路由到当前版本；预览特性不得视为默认可用。
+5. 只报告可复现、有代码证据且影响明确的问题，按严重度给出最小修复建议。
+6. 未运行编译或测试时明确说明，不自动修改代码。
@@ -5,6 +5,8 @@ description: 按当前项目测试框架为后端代码设计、生成、修改

 # 后端测试

-从构建文件和现有测试确认框架、版本、目录和运行方式。优先选择不启动完整应用即可验证业务规则的最小测试层级；只有集成边界确实需要时才加载框架上下文。
+从构建文件和现有测试确认框架、版本、目录和运行方式。按目标模块请求 `backend-testing` 和 `command-resolution`；当前会话未发现语言提供方时使用通用测试原则并报告缺口，不扫描插件缓存。优先选择不启动完整应用即可验证业务规则的最小测试层级；只有集成边界确实需要时才加载框架上下文。

 测试应覆盖可观察行为，不绑定私有实现；外部依赖使用项目已有隔离方式，不连接真实生产资源。运行聚焦测试后分别报告通过、失败、未执行和环境阻塞。新增依赖、修改业务代码、删除既有测试或运行需要真实服务的测试必须先说明并取得相应授权。
+
+Profile 返回的命令只是候选。只有项目脚本、构建文件、CI 配置或用户确认支持时才执行；不得因公共 Profile 自动新增测试依赖。