feat(knowledge): 接入文档持续维护约定

2026-09-03 15:54:12 +08:00
parent 0eaccca7cf
commit 9060fe5222
18 changed files with 61 additions and 19 deletions
@@ -27,6 +27,7 @@ python scripts/archive.py --root <project> --config <rules.json> --apply [--repo
 - 专有文档拆分逻辑改为通用 Markdown 标题章节抽取。
 - 内部数据库或服务校验改为显式 `requiredText` 内容校验；需要外部事实时由用户先提供结果，不隐式连接系统。
 - 来源专属元数据清理改为可选 `stripFrontmatter`，不会默认删除内容。
+- 历史归档保留当时快照并标明归档用途；它不作为当前有效依据。发现错误时增加勘误或当前版本链接，不静默改写历史内容。

 ## 安全边界

@@ -1,4 +1,4 @@
 interface:
  display_name: "Archive Documents（doc:archive）"
-  short_description: "按项目规则安全预演并归档文档"
+  short_description: "归档历史快照并关联当前有效版本"
  default_prompt: "使用 $archive 根据项目规则预演文档归档，确认后再执行写入。"
@@ -9,4 +9,4 @@ description: 将技术说明、问题描述、会议材料或现有实现整理

 技术实现细节只有在构成真实约束时才保留；不能从代码结构反推业务意图。冲突、模糊词、缺失规则和不可测试表述进入疑问清单。默认在对话中展示；用户要求保存时先展示待确认内容，再读取 `.craftkit/project.json` 的 `documents` 配置，过程需求使用 `workRoot`，共享需求使用 `designRoot`。

-写入后在 `workRoot/<task>/task.json` 登记本次过程或共享文档；已有记录时保守合并，只更新本任务拥有的文件。登记结构遵循 `knowledge:document-output` 的生命周期规则，不修改项目级默认配置。
+落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 `.craftkit/standards/document-maintenance.md` 更新审核状态；排版和错字修正不改变状态。`r`n`r`n写入后在 `workRoot/<task>/task.json` 登记本次创建、更新或引用的文档及 `relationship`；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。
@@ -1,4 +1,4 @@
 interface:
  display_name: "需求整理（doc:requirements）"
-  short_description: "将技术输入整理为可确认的需求说明"
-  default_prompt: "使用 $requirements 将这些材料整理成需求和疑问清单。"
+  short_description: "创建或更新可审核的需求说明"
+  default_prompt: "使用 $requirements 查找并更新已有需求，或将这些材料整理成新的需求和疑问清单。"