feat(knowledge): 统一维护项目文档落盘配置

2026-09-03 13:30:14 +08:00
parent a6bd0fddcf
commit aa87b8cf0b
11 changed files with 73 additions and 7 deletions
@@ -11,10 +11,26 @@
 - `dependencies.internal` 只记录用户确认可在当前仓库共享的依赖标识和用途。
 - `frontend` 记录前端框架、组件库、组件根和文档入口；路径必须是项目相对路径，版本必须有依赖清单、锁文件或用户确认作为证据。
 - `commands` 只记录经过项目文件或用户确认的命令。
- `documents.archiveRoot` 记录可共享的文档归档根；`documents.archiveRules` 记录项目确认的匹配、目标模板、转换和校验规则，不写入公司固定目录或外部系统凭据。
+- `documents` 区分过程文档、共享设计和归档目录，字段及回退行为见下方“文档目录”；归档规则不写入公司固定目录或外部系统凭据。
 - `guidance` 指向 `.craftkit/` 内的索引入口。
 - `initialization.references` 记录参考项目名称、用途、允许提炼范围和可共享的相对位置。

+## 文档目录
+
+| 字段 | 默认值 | 用途 |
+| --- | --- | --- |
+| `workRoot` | `.craftkit/local/tasks` | 开发中的需求、计划、设计草稿和验证记录，默认不提交 |
+| `designRoot` | `.craftkit/designs` | 用户明确要求共享或正式交付的设计文档 |
+| `archiveRoot` | `docs/archive` | 用户按归档规则处理的历史或正式归档文档 |
+| `archiveRules` | `[]` | 归档匹配、目标、转换和校验规则 |
+
+- 路径使用项目相对路径和正斜杠，不能包含 `..`、用户目录或其他个人机器绝对路径。
+- 初始化只写入配置，不预建空任务目录、设计目录或归档目录。
+- 成熟项目已有明确的过程文档或正式设计目录时优先延续，并展示证据；根目录中的 README、CHANGELOG 或总体工作流不能单独证明根目录是任务文档目录。
+- 用户未指定共享用途时，Skill 生成的过程文档使用 `workRoot`；用户明确要求共享或正式交付时使用 `designRoot`。
+- `archiveRoot` 不作为开发中内容的默认写入位置，归档必须按归档 Skill 的规则另行执行。
+- 旧配置只有 `archiveRoot` 时继续兼容读取；初始化更新时展示新增字段及用途，确认后保守合并。
+
 ## 前端组件信息

 - `frontend.framework` 引用 `technology.frameworks` 中已确认的前端框架名称。