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

2026-09-03 17:12:54 +08:00
parent 199a14daea
commit 018bc2e914
6 changed files with 34 additions and 16 deletions
@@ -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 只提供公共技术资料。
+
+输出中报告目标模块、版本证据、提供方、能力状态、项目覆盖和未覆盖范围。版本不匹配时不得加载冲突资料。