fix(dev): 从本地项目配置读取文档目录

2026-09-03 13:30:15 +08:00
parent aa87b8cf0b
commit 6e43bd9460
10 changed files with 13 additions and 9 deletions
@@ -1,6 +1,6 @@
 {
  "name": "dev",
-  "version": "0.4.1",
+  "version": "0.4.2",
  "description": "通用软件设计、编码、审查与测试工作流。",
  "author": {
    "name": "CraftKit"
@@ -7,4 +7,4 @@ description: 分析 CSV、表格或结构化 Bug 清单，规范化字段、去

 以原始数据为证据，先识别编码、分隔符、字段含义和缺失值，再建立不改变原始文件的规范化视图。

-输出总量、状态、严重度、模块、时间和重复项统计，并区分数据事实、合理推断和待确认项。分类规则和时间范围必须透明；样本不足时不外推。默认只生成对话报告，用户要求落盘时确认格式与路径；不得自动修改 Bug 状态、分派人员或修复代码。
+输出总量、状态、严重度、模块、时间和重复项统计，并区分数据事实、合理推断和待确认项。分类规则和时间范围必须透明；样本不足时不外推。默认只生成对话报告；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程报告使用 `workRoot`，共享报告使用 `designRoot`。不得自动修改 Bug 状态、分派人员或修复代码。
@@ -13,6 +13,7 @@ description: 基于项目需求、现有契约和对应版本官方规范设计
 2. 明确资源、动作、幂等性、认证授权、输入、输出和错误语义。
 3. 方法、状态码、缓存、条件请求和重试语义以 [官方来源](references/sources.md) 及项目版本为依据。
 4. 输出路径与方法、参数位置、请求响应模型、错误、兼容、弃用和测试清单。
-5. 未确认的业务规则和框架封装列为待确认，不生成实现代码。
+5. 默认在对话中输出；用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`，不改变接口自身的路径设计。
+6. 未确认的业务规则和框架封装列为待确认，不生成实现代码。

 项目规则高于公共建议；不得默认最新 OpenAPI 版本或把内部接口模式写成通用规则。
@@ -14,7 +14,7 @@ description: 基于需求、现有后端代码和项目规范设计模块边界
 3. 设计模块职责、调用关系、数据所有权、事务边界、并发策略、错误语义、权限和可观测性。
 4. 数据库或 HTTP 契约需要详细设计时，记录输入和待决项，交由相应专项 Skill；本 Skill 保持整体一致性。
 5. 按 [设计输出](references/output.md) 展示方案、备选项和风险，并用 [评审清单](references/review.md) 自检。
-6. 默认在对话中输出；用户要求落盘时，先确认项目约定路径并保守写入。
+6. 默认在对话中输出；用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`，并保守写入。

 ## 边界

@@ -13,6 +13,7 @@ description: 根据业务数据、访问模式和目标数据库版本设计或
 2. 设计实体、关系、主键、约束、类型、索引和数据生命周期。
 3. 按 [官方来源](references/sources.md) 核实目标版本语法及行为，不跨数据库复制 DDL。
 4. 输出结构、约束、索引依据、迁移顺序、兼容、回滚和验证查询。
-5. 默认只给方案；执行 DDL、迁移存量数据或连接数据库需要单独授权。
+5. 用户要求保存设计说明时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；可执行迁移文件仍沿用项目迁移工具约定。
+6. 默认只给方案；执行 DDL、迁移存量数据或连接数据库需要单独授权。

 未知容量、并发和查询模式应标为假设，不凭惯例制造审计字段或业务枚举。
@@ -14,5 +14,6 @@ description: 设计前端请求边界、视图模型、状态所有权、缓存
 3. 设计加载、成功、空、错误、取消、重试、竞态、缓存失效和乐观更新行为。
 4. 按 [官方来源](references/sources.md) 核实浏览器请求和框架状态语义。
 5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点，不预设字段或请求封装。
+6. 用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`。

 具体 API 字段映射交由 `prepare-api`，页面组合交由 `design-frontend`。
@@ -14,7 +14,7 @@ description: 基于需求、现有前端代码和项目规范设计页面清单
 3. 按 [数据设计](references/data.md) 设计视图模型、状态所有权、加载与提交转换、错误和权限呈现。
 4. 组件、样式和表单结构分别复用 `component`、`style`、`form` 的证据与结论；本 Skill 负责页面级组合。
 5. API 契约需要映射时交由 `prepare-api`，并在设计中记录所需接口、字段和未决项。
-6. 按 [设计输出](references/output.md) 展示方案和风险；用户要求落盘时，先确认项目约定路径。
+6. 按 [设计输出](references/output.md) 展示方案和风险；用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`。

 ## 边界

@@ -14,3 +14,4 @@ description: 基于项目现有流程引擎契约、业务状态和用户输入
 3. 设计业务事务与流程事务边界、幂等键、审计、通知和失败恢复。
 4. 需要过程建模时可参考 [官方来源](references/sources.md)，但必须映射回项目真实引擎能力。
 5. 输出状态转换表、时序、异常路径、接口需求、数据需求和验收场景；未确认规则列为待确认。
+6. 用户要求保存设计文档时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；业务流程配置和脚本沿用项目源码约定。
@@ -14,11 +14,11 @@ description: 分析软件需求或问题的现状、影响范围、依赖顺序
 3. 确认当前行为、目标行为、范围外事项、依赖、兼容要求和验收标准。
 4. 根据任务类型读取 [新功能](references/feature.md)、[现有变更](references/change.md) 或 [缺陷与重构](references/fix.md)。
 5. 输出按依赖排序的步骤，每步包含目标、证据、修改范围、输入、产物、验证和停止条件。
-6. 默认在对话中展示；用户要求保存时，先确认项目约定的路径再写入。
+6. 默认在对话中展示；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程计划使用 `workRoot`，共享计划使用 `designRoot`，后续设计沿用同一任务目录。

 ## 边界

- 不使用固定模块编码、固定文档目录或不存在的下游 Skill 名称。
+- 不使用固定模块编码或不存在的下游 Skill 名称；文档默认落点允许由用户路径和项目配置覆盖。
 - 无法从源码确认的运行行为标为待验证，不把推断写成事实。
 - 计划应保护现有工作区，并把外部环境、数据迁移和发布验证与本地代码验证分开。
 - 用户要求直接实施且任务简单明确时，不额外制造计划文档。
@@ -14,7 +14,7 @@ description: 对照前端需求或设计与现有 API 契约，整理接口清
 3. 按 [映射规则](references/mapping.md) 建立接口、请求、响应和双向类型转换映射。
 4. 分别列出已匹配、未匹配、冲突、缺失接口和需要后端或产品确认的事项。
 5. 按 [评审清单](references/review.md) 检查错误、分页、精度、时间、空值、权限和兼容风险。
-6. 默认在对话中输出；用户要求保存时，先确认项目约定路径再写入。
+6. 默认在对话中输出；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程映射使用 `workRoot`，共享映射使用 `designRoot`。

 ## 边界