fix(dev): 登记任务文档归属
This commit is contained in:
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "dev",
|
"name": "dev",
|
||||||
"version": "0.4.2",
|
"version": "0.4.3",
|
||||||
"description": "通用软件设计、编码、审查与测试工作流。",
|
"description": "通用软件设计、编码、审查与测试工作流。",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "CraftKit"
|
"name": "CraftKit"
|
||||||
|
|||||||
@@ -8,3 +8,5 @@ description: 分析 CSV、表格或结构化 Bug 清单,规范化字段、去
|
|||||||
以原始数据为证据,先识别编码、分隔符、字段含义和缺失值,再建立不改变原始文件的规范化视图。
|
以原始数据为证据,先识别编码、分隔符、字段含义和缺失值,再建立不改变原始文件的规范化视图。
|
||||||
|
|
||||||
输出总量、状态、严重度、模块、时间和重复项统计,并区分数据事实、合理推断和待确认项。分类规则和时间范围必须透明;样本不足时不外推。默认只生成对话报告;用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置,过程报告使用 `workRoot`,共享报告使用 `designRoot`。不得自动修改 Bug 状态、分派人员或修复代码。
|
输出总量、状态、严重度、模块、时间和重复项统计,并区分数据事实、合理推断和待确认项。分类规则和时间范围必须透明;样本不足时不外推。默认只生成对话报告;用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置,过程报告使用 `workRoot`,共享报告使用 `designRoot`。不得自动修改 Bug 状态、分派人员或修复代码。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
|
|||||||
@@ -14,6 +14,8 @@ description: 基于项目需求、现有契约和对应版本官方规范设计
|
|||||||
3. 方法、状态码、缓存、条件请求和重试语义以 [官方来源](references/sources.md) 及项目版本为依据。
|
3. 方法、状态码、缓存、条件请求和重试语义以 [官方来源](references/sources.md) 及项目版本为依据。
|
||||||
4. 输出路径与方法、参数位置、请求响应模型、错误、兼容、弃用和测试清单。
|
4. 输出路径与方法、参数位置、请求响应模型、错误、兼容、弃用和测试清单。
|
||||||
5. 默认在对话中输出;用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`,不改变接口自身的路径设计。
|
5. 默认在对话中输出;用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`,不改变接口自身的路径设计。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
6. 未确认的业务规则和框架封装列为待确认,不生成实现代码。
|
6. 未确认的业务规则和框架封装列为待确认,不生成实现代码。
|
||||||
|
|
||||||
项目规则高于公共建议;不得默认最新 OpenAPI 版本或把内部接口模式写成通用规则。
|
项目规则高于公共建议;不得默认最新 OpenAPI 版本或把内部接口模式写成通用规则。
|
||||||
|
|||||||
@@ -16,6 +16,8 @@ description: 基于需求、现有后端代码和项目规范设计模块边界
|
|||||||
5. 按 [设计输出](references/output.md) 展示方案、备选项和风险,并用 [评审清单](references/review.md) 自检。
|
5. 按 [设计输出](references/output.md) 展示方案、备选项和风险,并用 [评审清单](references/review.md) 自检。
|
||||||
6. 默认在对话中输出;用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`,并保守写入。
|
6. 默认在对话中输出;用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`,并保守写入。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
|
|
||||||
## 边界
|
## 边界
|
||||||
|
|
||||||
- 已安装 `guidance` 时用它获取项目规则;未安装时按“目标目录适用的 `AGENTS.md` → `.craftkit/agents/index.md` → `.craftkit/standards/index.md` → 命中正文”的顺序手工读取。不存在的规范、框架能力和依赖接口不得猜测。
|
- 已安装 `guidance` 时用它获取项目规则;未安装时按“目标目录适用的 `AGENTS.md` → `.craftkit/agents/index.md` → `.craftkit/standards/index.md` → 命中正文”的顺序手工读取。不存在的规范、框架能力和依赖接口不得猜测。
|
||||||
|
|||||||
@@ -16,4 +16,6 @@ description: 设计前端请求边界、视图模型、状态所有权、缓存
|
|||||||
5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点,不预设字段或请求封装。
|
5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点,不预设字段或请求封装。
|
||||||
6. 用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`。
|
6. 用户要求保存设计文档时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
|
|
||||||
具体 API 字段映射交由 `prepare-api`,页面组合交由 `design-frontend`。
|
具体 API 字段映射交由 `prepare-api`,页面组合交由 `design-frontend`。
|
||||||
|
|||||||
@@ -16,6 +16,8 @@ description: 基于需求、现有前端代码和项目规范设计页面清单
|
|||||||
5. API 契约需要映射时交由 `prepare-api`,并在设计中记录所需接口、字段和未决项。
|
5. API 契约需要映射时交由 `prepare-api`,并在设计中记录所需接口、字段和未决项。
|
||||||
6. 按 [设计输出](references/output.md) 展示方案和风险;用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`。
|
6. 按 [设计输出](references/output.md) 展示方案和风险;用户要求落盘时读取 `.craftkit/project.json` 的 `documents` 配置,过程设计使用 `workRoot`,共享设计使用 `designRoot`。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
|
|
||||||
## 边界
|
## 边界
|
||||||
|
|
||||||
- 不从接口字段描述反向改写已确认的用户文案和交互含义。
|
- 不从接口字段描述反向改写已确认的用户文案和交互含义。
|
||||||
|
|||||||
@@ -16,6 +16,8 @@ description: 分析软件需求或问题的现状、影响范围、依赖顺序
|
|||||||
5. 输出按依赖排序的步骤,每步包含目标、证据、修改范围、输入、产物、验证和停止条件。
|
5. 输出按依赖排序的步骤,每步包含目标、证据、修改范围、输入、产物、验证和停止条件。
|
||||||
6. 默认在对话中展示;用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置,过程计划使用 `workRoot`,共享计划使用 `designRoot`,后续设计沿用同一任务目录。
|
6. 默认在对话中展示;用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置,过程计划使用 `workRoot`,共享计划使用 `designRoot`,后续设计沿用同一任务目录。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
|
|
||||||
## 边界
|
## 边界
|
||||||
|
|
||||||
- 不使用固定模块编码或不存在的下游 Skill 名称;文档默认落点允许由用户路径和项目配置覆盖。
|
- 不使用固定模块编码或不存在的下游 Skill 名称;文档默认落点允许由用户路径和项目配置覆盖。
|
||||||
|
|||||||
@@ -16,6 +16,8 @@ description: 对照前端需求或设计与现有 API 契约,整理接口清
|
|||||||
5. 按 [评审清单](references/review.md) 检查错误、分页、精度、时间、空值、权限和兼容风险。
|
5. 按 [评审清单](references/review.md) 检查错误、分页、精度、时间、空值、权限和兼容风险。
|
||||||
6. 默认在对话中输出;用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置,过程映射使用 `workRoot`,共享映射使用 `designRoot`。
|
6. 默认在对话中输出;用户要求保存时读取 `.craftkit/project.json` 的 `documents` 配置,过程映射使用 `workRoot`,共享映射使用 `designRoot`。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
|
|
||||||
## 边界
|
## 边界
|
||||||
|
|
||||||
- API 文档不能反向覆盖已经确认的页面文案、业务含义和交互要求。
|
- API 文档不能反向覆盖已经确认的页面文案、业务含义和交互要求。
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "doc",
|
"name": "doc",
|
||||||
"version": "0.3.2",
|
"version": "0.3.3",
|
||||||
"description": "通用文档转换、表格提取、规则化归档与写作工具。",
|
"description": "通用文档转换、表格提取、规则化归档与写作工具。",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "CraftKit"
|
"name": "CraftKit"
|
||||||
|
|||||||
@@ -37,3 +37,5 @@ python scripts/archive.py --root <project> --config <rules.json> --apply [--repo
|
|||||||
- 规则不执行 Shell、SQL、模板代码或网络请求。
|
- 规则不执行 Shell、SQL、模板代码或网络请求。
|
||||||
|
|
||||||
完整配置见 `references/config.md`。
|
完整配置见 `references/config.md`。
|
||||||
|
|
||||||
|
当归档由任务关闭流程触发时,只复制 `task.json` 中标记为 `archive` 的文件。归档成功后将来源交回关闭流程重新分类;本 Skill 仍不删除来源,也不直接把来源标记为删除,实际删除只能由 `knowledge:document-output close` 按已确认清单执行。
|
||||||
|
|||||||
@@ -8,3 +8,5 @@ description: 将技术说明、问题描述、会议材料或现有实现整理
|
|||||||
保留输入事实与来源,区分当前行为、期望行为、建议和待确认项。先识别角色、场景、触发条件、主流程、异常流程、数据、权限、兼容和范围外事项,再生成可测试的验收标准。
|
保留输入事实与来源,区分当前行为、期望行为、建议和待确认项。先识别角色、场景、触发条件、主流程、异常流程、数据、权限、兼容和范围外事项,再生成可测试的验收标准。
|
||||||
|
|
||||||
技术实现细节只有在构成真实约束时才保留;不能从代码结构反推业务意图。冲突、模糊词、缺失规则和不可测试表述进入疑问清单。默认在对话中展示;用户要求保存时先展示待确认内容,再读取 `.craftkit/project.json` 的 `documents` 配置,过程需求使用 `workRoot`,共享需求使用 `designRoot`。
|
技术实现细节只有在构成真实约束时才保留;不能从代码结构反推业务意图。冲突、模糊词、缺失规则和不可测试表述进入疑问清单。默认在对话中展示;用户要求保存时先展示待确认内容,再读取 `.craftkit/project.json` 的 `documents` 配置,过程需求使用 `workRoot`,共享需求使用 `designRoot`。
|
||||||
|
|
||||||
|
写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档;已有记录时保守合并,只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则,不修改项目级默认配置。
|
||||||
|
|||||||
Reference in New Issue
Block a user