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

2026-09-03 13:30:14 +08:00
parent a6bd0fddcf
commit aa87b8cf0b
11 changed files with 73 additions and 7 deletions
@@ -12,6 +12,7 @@ CraftKit 面向 Codex 插件市场，提供简洁、中性、可独立安装和
 - Agent 补充说明：`.craftkit/agents/index.md`
 - 项目规范索引：`.craftkit/standards/index.md`
 - 项目知识索引：`.craftkit/knowledge/index.md`
+- 文档目录配置：`.craftkit/project.json` 的 `documents`；过程文档、共享设计和归档目录必须分开使用。

 ## 沟通与改动

@@ -75,6 +76,7 @@ plugins/<plugin>/skills/<skill>/
 - `.craftkit/` 是项目级 Agent 配置、规范、知识和运行状态的统一目录，目录名固定为全小写；不能把整个目录视为本地缓存或整体排除。
 - 可共享内容包括 `project.json`、`agents/`、`standards/`、`knowledge/` 和 `handoff/`，可以根据用户确认正常提交和同步。
 - `project.json` 记录项目类型、技术栈、源码与包边界、内部依赖标识、常用命令和规范入口；不得记录凭据、完整连接信息或个人机器绝对路径。
+- 开发中的需求、计划、设计和验证记录默认放入 `documents.workRoot`；用户明确要求共享或正式交付时使用 `documents.designRoot`，历史归档使用 `documents.archiveRoot`。没有字段时分别回退到 `.craftkit/local/tasks/`、`.craftkit/designs/` 和项目已配置的归档根。
 - 成熟项目优先延续已有且有充分证据的风格；空项目根据需求、用户选择和已授权参考建立最小上下文，不自行猜测框架、包名或内部依赖。
 - 引用其他项目时先确认参考范围，只提炼结构、依赖、命名、测试、规范或工具约定；共享配置优先记录相对路径，不能共享的本地位置放入 `local/`。
 - 公共框架版本差异由 CraftKit 公共 profile 维护；项目在 `project.json` 选择实际版本和 profile，并在 `standards/` 保存项目补充规则。