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