diff --git a/plugins/dev/.codex-plugin/plugin.json b/plugins/dev/.codex-plugin/plugin.json index 9d320ed..52de50a 100644 --- a/plugins/dev/.codex-plugin/plugin.json +++ b/plugins/dev/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "dev", - "version": "0.4.3", + "version": "0.5.0", "description": "通用软件设计、编码、审查与测试工作流。", "author": { "name": "CraftKit" @@ -9,7 +9,7 @@ "interface": { "displayName": "Dev", "shortDescription": "软件设计、编码、审查与测试工具", - "longDescription": "提供基于项目实际技术栈的设计、实现、审查、测试、升级与估算工作流。", + "longDescription": "提供基于项目实际技术栈的设计、实现、文档同步、审查、测试、升级与估算工作流。", "developerName": "CraftKit", "category": "Productivity", "capabilities": ["Read", "Write"], diff --git a/plugins/dev/skills/analyze-bugs/SKILL.md b/plugins/dev/skills/analyze-bugs/SKILL.md index 72c33dd..7c050b8 100644 --- a/plugins/dev/skills/analyze-bugs/SKILL.md +++ b/plugins/dev/skills/analyze-bugs/SKILL.md @@ -9,4 +9,4 @@ description: 分析 CSV、表格或结构化 Bug 清单，规范化字段、去 输出总量、状态、严重度、模块、时间和重复项统计，并区分数据事实、合理推断和待确认项。分类规则和时间范围必须透明；样本不足时不外推。默认只生成对话报告；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程报告使用 `workRoot`，共享报告使用 `designRoot`。不得自动修改 Bug 状态、分派人员或修复代码。 -写入后在 `workRoot//task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。 +落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot//task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。 diff --git a/plugins/dev/skills/component/SKILL.md b/plugins/dev/skills/component/SKILL.md index 0013288..69859ac 100644 --- a/plugins/dev/skills/component/SKILL.md +++ b/plugins/dev/skills/component/SKILL.md @@ -13,7 +13,7 @@ description: 根据当前项目的真实依赖、已有用法和可验证契约 2. 按 [选型规则](references/selection.md) 比较复用、扩展和新建方案。 3. 按 [证据规则](references/evidence.md) 查证组件契约及版本兼容性。 4. 输出推荐组件、适用理由、契约摘要、替代方案、缺口和风险。 -5. 用户需要持续复用扫描结果时，按 [组件索引](references/index.md) 展示拟新增或更新内容；确认后写入 `.craftkit/standards/frontend/components.md`。 +5. 用户需要持续复用扫描结果时，按 [组件索引](references/index.md) 展示拟新增或更新内容；确认后更新已有 `.craftkit/standards/frontend/components.md`，并按项目文档维护规范处理审核状态。 6. 如证据不足，说明缺少的材料并询问用户，不代替后续页面实现 Skill 编写完整页面。 项目没有 `.craftkit/project.json` 时，继续检查真实依赖和现有代码；只有缺失信息会改变结论时才询问用户。 diff --git a/plugins/dev/skills/design-api/SKILL.md b/plugins/dev/skills/design-api/SKILL.md index 5dbae95..bd2675d 100644 --- a/plugins/dev/skills/design-api/SKILL.md +++ b/plugins/dev/skills/design-api/SKILL.md @@ -15,7 +15,7 @@ description: 基于项目需求、现有契约和对应版本官方规范设计 4. 输出路径与方法、参数位置、请求响应模型、错误、兼容、弃用和测试清单。 5. 默认在对话中输出；用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`，不改变接口自身的路径设计。 -写入后在 `workRoot//task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。 +落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot//task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。 6. 未确认的业务规则和框架封装列为待确认，不生成实现代码。 项目规则高于公共建议；不得默认最新 OpenAPI 版本或把内部接口模式写成通用规则。 diff --git a/plugins/dev/skills/design-backend/SKILL.md b/plugins/dev/skills/design-backend/SKILL.md index 6089e9c..19f27d9 100644 --- a/plugins/dev/skills/design-backend/SKILL.md +++ b/plugins/dev/skills/design-backend/SKILL.md @@ -16,7 +16,7 @@ description: 基于需求、现有后端代码和项目规范设计模块边界 5. 按 [设计输出](references/output.md) 展示方案、备选项和风险，并用 [评审清单](references/review.md) 自检。 6. 默认在对话中输出；用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`，并保守写入。 -写入后在 `workRoot//task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。 +落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot//task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。 ## 边界 diff --git a/plugins/dev/skills/design-db/SKILL.md b/plugins/dev/skills/design-db/SKILL.md index 2ff54a1..8a6ab5d 100644 --- a/plugins/dev/skills/design-db/SKILL.md +++ b/plugins/dev/skills/design-db/SKILL.md @@ -13,7 +13,9 @@ description: 根据业务数据、访问模式和目标数据库版本设计或 2. 设计实体、关系、主键、约束、类型、索引和数据生命周期。 3. 按 [官方来源](references/sources.md) 核实目标版本语法及行为，不跨数据库复制 DDL。 4. 输出结构、约束、索引依据、迁移顺序、兼容、回滚和验证查询。 -5. 用户要求保存设计说明时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；可执行迁移文件仍沿用项目迁移工具约定。 +5. 用户要求保存设计说明时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；先检索并更新已有权威数据设计，实质修改共享文档后按项目文档维护规范更新审核状态。 6. 默认只给方案；执行 DDL、迁移存量数据或连接数据库需要单独授权。 +写入后在 `workRoot//task.json` 登记创建、更新或引用关系。已有文档属于其他任务时只登记关联，不取得删除权限；可执行迁移文件仍沿用项目迁移工具约定。 + 未知容量、并发和查询模式应标为假设，不凭惯例制造审计字段或业务枚举。 diff --git a/plugins/dev/skills/design-frontend-data/SKILL.md b/plugins/dev/skills/design-frontend-data/SKILL.md index 7740a1c..2d54669 100644 --- a/plugins/dev/skills/design-frontend-data/SKILL.md +++ b/plugins/dev/skills/design-frontend-data/SKILL.md @@ -16,6 +16,6 @@ description: 设计前端请求边界、视图模型、状态所有权、缓存 5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点，不预设字段或请求封装。 6. 用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`。 -写入后在 `workRoot//task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。 +落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot//task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。 具体 API 字段映射交由 `prepare-api`，页面组合交由 `design-frontend`。 diff --git a/plugins/dev/skills/design-frontend/SKILL.md b/plugins/dev/skills/design-frontend/SKILL.md index 821dfbc..fcba0c0 100644 --- a/plugins/dev/skills/design-frontend/SKILL.md +++ b/plugins/dev/skills/design-frontend/SKILL.md @@ -16,7 +16,7 @@ description: 基于需求、现有前端代码和项目规范设计页面清单 5. API 契约需要映射时交由 `prepare-api`，并在设计中记录所需接口、字段和未决项。 6. 按 [设计输出](references/output.md) 展示方案和风险；用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置，过程设计使用 `workRoot`，共享设计使用 `designRoot`。 -写入后在 `workRoot//task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。 +落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot//task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。 ## 边界 diff --git a/plugins/dev/skills/design-workflow/SKILL.md b/plugins/dev/skills/design-workflow/SKILL.md index 6e58ea2..338f39f 100644 --- a/plugins/dev/skills/design-workflow/SKILL.md +++ b/plugins/dev/skills/design-workflow/SKILL.md @@ -14,4 +14,6 @@ description: 基于项目现有流程引擎契约、业务状态和用户输入 3. 设计业务事务与流程事务边界、幂等键、审计、通知和失败恢复。 4. 需要过程建模时可参考 [官方来源](references/sources.md)，但必须映射回项目真实引擎能力。 5. 输出状态转换表、时序、异常路径、接口需求、数据需求和验收场景；未确认规则列为待确认。 -6. 用户要求保存设计文档时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；业务流程配置和脚本沿用项目源码约定。 +6. 用户要求保存设计文档时，读取 `.craftkit/project.json` 的 `documents` 配置选择过程或共享目录；先检索并更新已有权威流程设计，实质修改共享文档后按项目文档维护规范更新审核状态。 + +写入后在 `workRoot//task.json` 登记创建、更新或引用关系。已有文档属于其他任务时只登记关联，不取得删除权限；业务流程配置和脚本沿用项目源码约定。 diff --git a/plugins/dev/skills/implement-backend/SKILL.md b/plugins/dev/skills/implement-backend/SKILL.md index a67a4b6..407ff77 100644 --- a/plugins/dev/skills/implement-backend/SKILL.md +++ b/plugins/dev/skills/implement-backend/SKILL.md @@ -11,9 +11,10 @@ description: 按当前项目真实语言、框架版本、规范和现有实现 1. 检查 Git 状态，保留用户已有改动；确认目标、范围和不可修改项。 2. 读取 `AGENTS.md`、`.craftkit/project.json`，从构建文件确认真实版本。已安装 `guidance` 时用它检索规范；未安装时按“目标目录适用的 `AGENTS.md` → `.craftkit/agents/index.md` → `.craftkit/standards/index.md` → 命中正文”的顺序手工读取，不因缺少另一插件中断实现。 -3. 追踪入口、调用链、数据流、测试和相邻稳定实现；设计不足时先补最小决策，不套用固定模板。 +3. 追踪入口、调用链、数据流、测试和相邻稳定实现；检索相关需求、设计、规范和知识，设计不足时先补最小决策，不套用固定模板。 4. 实施最小完整变更，保持项目目录、依赖、异常、事务、日志和测试风格。 -5. 执行项目已有的编译、静态检查和相关测试，分别报告未执行的真实环境验证。 +5. 检查本次接口、数据模型、业务行为和验证结论是否使长期文档过期；更新受影响的权威文档并登记到当前 `task.json`，不能完成时标为 `outdated` 并列入待办。 +6. 执行项目已有的编译、静态检查和相关测试，分别报告未执行的真实环境验证。 ## 安全边界 diff --git a/plugins/dev/skills/implement-backend/agents/openai.yaml b/plugins/dev/skills/implement-backend/agents/openai.yaml index 470bc57..425b4d9 100644 --- a/plugins/dev/skills/implement-backend/agents/openai.yaml +++ b/plugins/dev/skills/implement-backend/agents/openai.yaml @@ -1,4 +1,4 @@ interface: display_name: "后端实现（dev:implement-backend）" - short_description: "按项目版本与规范实现后端代码变更" - default_prompt: "使用 $implement-backend 实现并验证当前后端需求。" + short_description: "实现后端变更并同步受影响的长期文档" + default_prompt: "使用 $implement-backend 实现并验证当前后端需求，同时检查并更新受影响的长期文档。" diff --git a/plugins/dev/skills/implement-frontend/SKILL.md b/plugins/dev/skills/implement-frontend/SKILL.md index d015571..91f9d70 100644 --- a/plugins/dev/skills/implement-frontend/SKILL.md +++ b/plugins/dev/skills/implement-frontend/SKILL.md @@ -11,9 +11,10 @@ description: 按当前项目框架版本、组件契约、设计令牌和请求 1. 检查 Git 状态并确认目标文件；从项目元数据、依赖和锁文件识别框架、构建工具及精确版本。 2. 已安装 `guidance` 时用它检索规范；未安装时按“目标目录适用的 `AGENTS.md` → `.craftkit/agents/index.md` → `.craftkit/standards/index.md` → 命中正文”的顺序手工读取。随后检查相邻页面和公共封装；组件、样式、表单分别消费 `component`、`style`、`form` 的证据。 -3. 有设计与接口映射时消费 `design-frontend` 和 `prepare-api`；没有时只补当前实现必需的最小决策。 +3. 检索相关需求、设计、规范和知识；有设计与接口映射时消费 `design-frontend` 和 `prepare-api`，没有时只补当前实现必需的最小决策。 4. 修改页面、路由、状态和 API 层，保持项目现有契约，不虚构组件、props、事件、接口或业务校验。 -5. 执行已有格式化、类型检查、测试和构建；未进行真实渲染或浏览器验证时明确说明。 +5. 检查本次页面行为、接口字段、路由、状态和验证结论是否使长期文档过期；更新受影响的权威文档并登记到当前 `task.json`，不能完成时标为 `outdated` 并列入待办。 +6. 执行已有格式化、类型检查、测试和构建；未进行真实渲染或浏览器验证时明确说明。 ## 安全边界 diff --git a/plugins/dev/skills/implement-frontend/agents/openai.yaml b/plugins/dev/skills/implement-frontend/agents/openai.yaml index 2d61c12..68e115d 100644 --- a/plugins/dev/skills/implement-frontend/agents/openai.yaml +++ b/plugins/dev/skills/implement-frontend/agents/openai.yaml @@ -1,4 +1,4 @@ interface: display_name: "前端实现（dev:implement-frontend）" - short_description: "按项目框架与组件契约实现前端变更" - default_prompt: "使用 $implement-frontend 实现并验证当前前端需求。" + short_description: "实现前端变更并同步受影响的长期文档" + default_prompt: "使用 $implement-frontend 实现并验证当前前端需求，同时检查并更新受影响的长期文档。" diff --git a/plugins/dev/skills/plan-change/SKILL.md b/plugins/dev/skills/plan-change/SKILL.md index 25fa393..a565fe4 100644 --- a/plugins/dev/skills/plan-change/SKILL.md +++ b/plugins/dev/skills/plan-change/SKILL.md @@ -16,7 +16,7 @@ description: 分析软件需求或问题的现状、影响范围、依赖顺序 5. 输出按依赖排序的步骤，每步包含目标、证据、修改范围、输入、产物、验证和停止条件。 6. 默认在对话中展示；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程计划使用 `workRoot`，共享计划使用 `designRoot`，后续设计沿用同一任务目录。 -写入后在 `workRoot//task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。 +落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot//task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。 ## 边界 diff --git a/plugins/dev/skills/prepare-api/SKILL.md b/plugins/dev/skills/prepare-api/SKILL.md index 8130703..e566003 100644 --- a/plugins/dev/skills/prepare-api/SKILL.md +++ b/plugins/dev/skills/prepare-api/SKILL.md @@ -16,7 +16,7 @@ description: 对照前端需求或设计与现有 API 契约，整理接口清 5. 按 [评审清单](references/review.md) 检查错误、分页、精度、时间、空值、权限和兼容风险。 6. 默认在对话中输出；用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置，过程映射使用 `workRoot`，共享映射使用 `designRoot`。 -写入后在 `workRoot//task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。 +落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot//task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。 ## 边界 diff --git a/plugins/dev/skills/review-code/SKILL.md b/plugins/dev/skills/review-code/SKILL.md index 2784507..b68edbf 100644 --- a/plugins/dev/skills/review-code/SKILL.md +++ b/plugins/dev/skills/review-code/SKILL.md @@ -5,7 +5,7 @@ description: 审查工作区、提交或分支中的代码变更，基于项目 # 代码审查 -默认只读。先确认基线和范围，再读取差异、调用方、测试与适用规范；不得只凭补丁片段猜测运行行为。 +默认只读。先确认基线和范围，再读取差异、调用方、测试、适用规范及本次关联的需求和设计；不得只凭补丁片段猜测运行行为。 ## 模式 @@ -13,4 +13,6 @@ description: 审查工作区、提交或分支中的代码变更，基于项目 - 提交：审查指定提交及其父提交差异。 - 分支：使用明确基线审查提交范围和最终差异。 -按严重度输出可操作问题，每项包含文件、位置、触发条件、影响和最小修复方向。没有问题时说明检查范围和未验证边界。审查不自动修复、暂存、提交或推送；静态审查不等同于测试和真实环境验收。 +按严重度输出可操作问题，每项包含文件、位置、触发条件、影响和最小修复方向。审核实现与当前有效文档是否一致，并检查本次变更影响的长期文档是否已更新；`pending`、`outdated`、缺少状态和历史归档分别如实报告，不能把历史材料当作当前依据。 + +没有问题时说明检查范围和未验证边界。审查不自动修改文档、代码、审核状态、暂存、提交或推送；静态审查不等同于测试、文档批准和真实环境验收。 diff --git a/plugins/dev/skills/review-code/agents/openai.yaml b/plugins/dev/skills/review-code/agents/openai.yaml index 5a48428..81987f6 100644 --- a/plugins/dev/skills/review-code/agents/openai.yaml +++ b/plugins/dev/skills/review-code/agents/openai.yaml @@ -1,4 +1,4 @@ interface: display_name: "代码审查（dev:review-code）" - short_description: "审查工作区、提交或分支的代码变更" - default_prompt: "使用 $review-code 审查当前代码变更并按严重度报告问题。" + short_description: "审查代码质量及实现与有效文档的一致性" + default_prompt: "使用 $review-code 审查当前代码变更、相关文档同步情况，并按严重度报告问题。" diff --git a/plugins/dev/skills/style/SKILL.md b/plugins/dev/skills/style/SKILL.md index 0a9cad2..e8f0100 100644 --- a/plugins/dev/skills/style/SKILL.md +++ b/plugins/dev/skills/style/SKILL.md @@ -13,7 +13,7 @@ description: 基于当前项目的设计令牌、主题、页面和用户参考 2. 按 [来源优先级](references/sources.md) 确定现有设计权威与用户参考的关系。 3. 识别需要继承、补充或覆盖的颜色、排版、间距、圆角、阴影、断点和交互状态。 4. 按 [输出约定](references/output.md) 给出规范或样式修改，并说明未验证风险。 -5. 需要写入 `.craftkit/standards/frontend/design.md` 时，先展示拟写内容和合并策略，经用户确认后再修改。 +5. 需要写入 `.craftkit/standards/frontend/design.md` 时，先读取原文并展示拟写内容和合并策略，经用户确认后更新；实质修改按项目文档维护规范重新审核。 如果项目没有视觉基线，先询问用户是否有设计稿、截图或参考项目；输入仍不足时只给出待确认项，不擅自确定品牌风格。 diff --git a/plugins/dev/skills/upgrade/SKILL.md b/plugins/dev/skills/upgrade/SKILL.md index 7229276..a22c1b8 100644 --- a/plugins/dev/skills/upgrade/SKILL.md +++ b/plugins/dev/skills/upgrade/SKILL.md @@ -7,4 +7,4 @@ description: 规划并实施前端、后端或依赖的大版本升级，基于 升级前必须确认当前版本、目标版本、支持矩阵、运行环境、锁文件和回滚要求。只读取对应产品的官方迁移指南、发行说明和弃用清单，并记录访问日期；不得使用来源插件的内部升级矩阵。 -先输出依赖差异、破坏性变化、代码与配置影响、数据或构建迁移、验证矩阵和回滚点。用户确认实施后分小步修改，每步运行项目已有检查。新增依赖下载或访问网络按环境授权执行。环境配置、生产数据、部署、提交、标签和推送均不在默认授权内。 +先输出依赖差异、破坏性变化、代码与配置影响、数据或构建迁移、验证矩阵和回滚点，并检索会被版本变化影响的长期设计、规范和知识。用户确认实施后分小步修改，每步运行项目已有检查，同步更新受影响的权威文档并按项目文档维护规范重新审核；不能完成时标为 `outdated`。新增依赖下载或访问网络按环境授权执行。环境配置、生产数据、部署、提交、标签和推送均不在默认授权内。