From 6e43bd946071691df6ac165853106cdb869acda7 Mon Sep 17 00:00:00 2001 From: "zhiye.sun" Date: Thu, 3 Sep 2026 13:30:15 +0800 Subject: [PATCH] =?UTF-8?q?fix(dev):=20=E4=BB=8E=E6=9C=AC=E5=9C=B0?= =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E9=85=8D=E7=BD=AE=E8=AF=BB=E5=8F=96=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- plugins/dev/.codex-plugin/plugin.json | 2 +- plugins/dev/skills/analyze-bugs/SKILL.md | 2 +- plugins/dev/skills/design-api/SKILL.md | 3 ++- plugins/dev/skills/design-backend/SKILL.md | 2 +- plugins/dev/skills/design-db/SKILL.md | 3 ++- plugins/dev/skills/design-frontend-data/SKILL.md | 1 + plugins/dev/skills/design-frontend/SKILL.md | 2 +- plugins/dev/skills/design-workflow/SKILL.md | 1 + plugins/dev/skills/plan-change/SKILL.md | 4 ++-- plugins/dev/skills/prepare-api/SKILL.md | 2 +- 10 files changed, 13 insertions(+), 9 deletions(-) diff --git a/plugins/dev/.codex-plugin/plugin.json b/plugins/dev/.codex-plugin/plugin.json index df12618..917771c 100644 --- a/plugins/dev/.codex-plugin/plugin.json +++ b/plugins/dev/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "dev", - "version": "0.4.1", + "version": "0.4.2", "description": "通用软件设计、编码、审查与测试工作流。", "author": { "name": "CraftKit" diff --git a/plugins/dev/skills/analyze-bugs/SKILL.md b/plugins/dev/skills/analyze-bugs/SKILL.md index 08bd663..8b8f344 100644 --- a/plugins/dev/skills/analyze-bugs/SKILL.md +++ b/plugins/dev/skills/analyze-bugs/SKILL.md @@ -7,4 +7,4 @@ description: 分析 CSV、表格或结构化 Bug 清单，规范化字段、去 以原始数据为证据，先识别编码、分隔符、字段含义和缺失值，再建立不改变原始文件的规范化视图。 -输出总量、状态、严重度、模块、时间和重复项统计，并区分数据事实、合理推断和待确认项。分类规则和时间范围必须透明；样本不足时不外推。默认只生成对话报告，用户要求落盘时确认格式与路径；不得自动修改 Bug 状态、分派人员或修复代码。 +输出总量、状态、严重度、模块、时间和重复项统计，并区分数据事实、合理推断和待确认项。分类规则和时间范围必须透明；样本不足时不外推。默认只生成对话报告；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程报告使用 `workRoot`，共享报告使用 `designRoot`。不得自动修改 Bug 状态、分派人员或修复代码。 diff --git a/plugins/dev/skills/design-api/SKILL.md b/plugins/dev/skills/design-api/SKILL.md index 6b03e2c..c3901d3 100644 --- a/plugins/dev/skills/design-api/SKILL.md +++ b/plugins/dev/skills/design-api/SKILL.md @@ -13,6 +13,7 @@ description: 基于项目需求、现有契约和对应版本官方规范设计 2. 明确资源、动作、幂等性、认证授权、输入、输出和错误语义。 3. 方法、状态码、缓存、条件请求和重试语义以 [官方来源](references/sources.md) 及项目版本为依据。 4. 输出路径与方法、参数位置、请求响应模型、错误、兼容、弃用和测试清单。 -5. 未确认的业务规则和框架封装列为待确认，不生成实现代码。 +5. 默认在对话中输出；用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`，不改变接口自身的路径设计。 +6. 未确认的业务规则和框架封装列为待确认，不生成实现代码。 项目规则高于公共建议；不得默认最新 OpenAPI 版本或把内部接口模式写成通用规则。 diff --git a/plugins/dev/skills/design-backend/SKILL.md b/plugins/dev/skills/design-backend/SKILL.md index 6c33ffc..87624cf 100644 --- a/plugins/dev/skills/design-backend/SKILL.md +++ b/plugins/dev/skills/design-backend/SKILL.md @@ -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`，并保守写入。 ## 边界 diff --git a/plugins/dev/skills/design-db/SKILL.md b/plugins/dev/skills/design-db/SKILL.md index e4003f3..2ff54a1 100644 --- a/plugins/dev/skills/design-db/SKILL.md +++ b/plugins/dev/skills/design-db/SKILL.md @@ -13,6 +13,7 @@ description: 根据业务数据、访问模式和目标数据库版本设计或 2. 设计实体、关系、主键、约束、类型、索引和数据生命周期。 3. 按 [官方来源](references/sources.md) 核实目标版本语法及行为，不跨数据库复制 DDL。 4. 输出结构、约束、索引依据、迁移顺序、兼容、回滚和验证查询。 -5. 默认只给方案；执行 DDL、迁移存量数据或连接数据库需要单独授权。 +5. 用户要求保存设计说明时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；可执行迁移文件仍沿用项目迁移工具约定。 +6. 默认只给方案；执行 DDL、迁移存量数据或连接数据库需要单独授权。 未知容量、并发和查询模式应标为假设，不凭惯例制造审计字段或业务枚举。 diff --git a/plugins/dev/skills/design-frontend-data/SKILL.md b/plugins/dev/skills/design-frontend-data/SKILL.md index b0bd81a..ccbee77 100644 --- a/plugins/dev/skills/design-frontend-data/SKILL.md +++ b/plugins/dev/skills/design-frontend-data/SKILL.md @@ -14,5 +14,6 @@ description: 设计前端请求边界、视图模型、状态所有权、缓存 3. 设计加载、成功、空、错误、取消、重试、竞态、缓存失效和乐观更新行为。 4. 按 [官方来源](references/sources.md) 核实浏览器请求和框架状态语义。 5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点，不预设字段或请求封装。 +6. 用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`。 具体 API 字段映射交由 `prepare-api`，页面组合交由 `design-frontend`。 diff --git a/plugins/dev/skills/design-frontend/SKILL.md b/plugins/dev/skills/design-frontend/SKILL.md index a3493cb..4b302c8 100644 --- a/plugins/dev/skills/design-frontend/SKILL.md +++ b/plugins/dev/skills/design-frontend/SKILL.md @@ -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`。 ## 边界 diff --git a/plugins/dev/skills/design-workflow/SKILL.md b/plugins/dev/skills/design-workflow/SKILL.md index ae2b37c..6e58ea2 100644 --- a/plugins/dev/skills/design-workflow/SKILL.md +++ b/plugins/dev/skills/design-workflow/SKILL.md @@ -14,3 +14,4 @@ description: 基于项目现有流程引擎契约、业务状态和用户输入 3. 设计业务事务与流程事务边界、幂等键、审计、通知和失败恢复。 4. 需要过程建模时可参考 [官方来源](references/sources.md)，但必须映射回项目真实引擎能力。 5. 输出状态转换表、时序、异常路径、接口需求、数据需求和验收场景；未确认规则列为待确认。 +6. 用户要求保存设计文档时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；业务流程配置和脚本沿用项目源码约定。 diff --git a/plugins/dev/skills/plan-change/SKILL.md b/plugins/dev/skills/plan-change/SKILL.md index dd73dc9..e635c02 100644 --- a/plugins/dev/skills/plan-change/SKILL.md +++ b/plugins/dev/skills/plan-change/SKILL.md @@ -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 名称；文档默认落点允许由用户路径和项目配置覆盖。 - 无法从源码确认的运行行为标为待验证，不把推断写成事实。 - 计划应保护现有工作区，并把外部环境、数据迁移和发布验证与本地代码验证分开。 - 用户要求直接实施且任务简单明确时，不额外制造计划文档。 diff --git a/plugins/dev/skills/prepare-api/SKILL.md b/plugins/dev/skills/prepare-api/SKILL.md index f79185b..4a338c4 100644 --- a/plugins/dev/skills/prepare-api/SKILL.md +++ b/plugins/dev/skills/prepare-api/SKILL.md @@ -14,7 +14,7 @@ description: 对照前端需求或设计与现有 API 契约，整理接口清 3. 按 [映射规则](references/mapping.md) 建立接口、请求、响应和双向类型转换映射。 4. 分别列出已匹配、未匹配、冲突、缺失接口和需要后端或产品确认的事项。 5. 按 [评审清单](references/review.md) 检查错误、分页、精度、时间、空值、权限和兼容风险。 -6. 默认在对话中输出；用户要求保存时，先确认项目约定路径再写入。 +6. 默认在对话中输出；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程映射使用 `workRoot`，共享映射使用 `designRoot`。 ## 边界