feat(knowledge): 增加任务文档生命周期
This commit is contained in:
@@ -1,11 +1,20 @@
|
||||
---
|
||||
name: document-output
|
||||
description: 查看、解释或维护项目的过程、共享和归档文档落盘配置。适用于初始化文档目录、处理路径冲突或用户明确要求调整落盘规则;普通开发 Skill 已能从 project.json 确定路径时不应触发。
|
||||
description: 查看、解释或维护项目文档落盘配置,登记任务文档,并在任务完成时预览和执行文档关闭。适用于调整路径或生命周期规则、确认文档归属、清理过程材料;普通开发 Skill 只需读取 project.json 时不应触发。
|
||||
---
|
||||
|
||||
# 项目文档落盘
|
||||
|
||||
本 Skill 维护 `.craftkit/project.json` 的 `documents` 配置并处理路径冲突,不代替需求、设计或分析 Skill 生成文档内容,也不把对话输出自动转为文件。初次创建配置由 `knowledge:init` 完成;本 Skill 用于后续查询和调整。
|
||||
本 Skill 维护 `.craftkit/project.json` 的 `documents` 配置、`workRoot/<task>/task.json` 任务记录和关闭门禁,不代替需求、设计或分析 Skill 生成文档内容,也不把对话输出自动转为文件。初次创建配置由 `knowledge:init` 完成。
|
||||
|
||||
## 选择模式
|
||||
|
||||
- `view`:解释当前路径、Git 可见性和生命周期策略。
|
||||
- `configure`:调整项目级 `documents` 配置。
|
||||
- `register`:在业务 Skill 写入任务文档时创建或更新 `task.json`。
|
||||
- `close`:任务完成后分类预览、沉淀、归档并清理任务文档。
|
||||
|
||||
执行 `register` 或 `close` 时读取[文档生命周期](references/lifecycle.md)。普通业务 Skill 可直接读取项目配置并按该引用中的最小字段更新 `task.json`,不需要递归调用本 Skill。
|
||||
|
||||
## 路径选择
|
||||
|
||||
@@ -27,6 +36,12 @@ description: 查看、解释或维护项目的过程、共享和归档文档落
|
||||
- 审批通过不代表共享、归档、提交或移动授权。共享设计不是已验证知识;只有经验证的可复用决策才按知识维护流程进入 `knowledge/decisions/`。
|
||||
- 交接仍使用交接 Skill 的 `.craftkit/local/handoff/` 或用户指定路径;不把交接、缓存、规范和设计目录混用。
|
||||
|
||||
## 任务关闭
|
||||
|
||||
`close` 先读取任务记录和实际文件,输出“保留、沉淀、归档、删除、延后”五类清单。完成状态不产生删除授权;只有用户已经明确批准该清单时,才能删除列入“删除”的精确路径。删除后检查任务目录、引用、Git 状态和仍需保留的文件,再把任务状态更新为 `closed`。
|
||||
|
||||
共享或已跟踪文件必须逐项评审。关闭过程不得删除 `.craftkit/local/config/`、凭据、个人配置、未登记文件或其他任务的文件;不确定归属时标记为“延后”。
|
||||
|
||||
## 结果
|
||||
|
||||
返回文档用途、项目相对目标路径、选取依据、忽略或共享状态以及冲突。用户要求修改配置时,先展示 `.craftkit/project.json` 的精确差异,确认后保守写入;具体文档仍由获得保存授权的业务 Skill 写入。
|
||||
`view`、`configure` 和 `register` 返回用途、目标路径、选取依据、Git 状态及冲突。`close` 返回任务状态、五类清单、已执行动作和剩余文件。用户要求修改配置时,先展示 `.craftkit/project.json` 的精确差异,确认后保守写入;具体文档仍由获得保存授权的业务 Skill 写入。
|
||||
|
||||
Reference in New Issue
Block a user