docs: Archive osmassets refactor plan

This commit is contained in:
2026-08-03 12:12:49 +08:00
parent 0b8195b43f
commit 68829214fb
8 changed files with 90 additions and 118 deletions

View File

@@ -0,0 +1,2 @@
{"file": ".trellis/spec/guides/artifact-parity-guide.md", "reason": "Check that parity/control knowledge survives after deleting the temporary refactor plan."}
{"file": ".trellis/spec/guides/index.md", "reason": "Check guide references remain accurate and no stale refactor-plan links remain."}

View File

@@ -0,0 +1,2 @@
{"file": ".trellis/spec/guides/artifact-parity-guide.md", "reason": "Contains refactor-plan status and references that must be preserved without linking to the deleted temporary file."}
{"file": ".trellis/spec/guides/index.md", "reason": "Shared guide routing for cross-layer and parity documentation changes."}

View File

@@ -0,0 +1,35 @@
# Archive refactor plan
**类型**docs · **范围**docs/spec · **创建**2026-08-03
---
## Goal
收尾临时文档 `docs/refactor-plan.md`:把仍有价值的 P0-P3 重构结论并入长期文档,
然后删除这份已过期的临时计划,避免后续 AI 或开发者读到 P3 未做、旧行号、旧 `CESIUM_EXPORT`
状态等过期事实。
## Requirements
1. `docs/changelog.md` 必须新增一条 2026-08-03 记录总结材质导出契约化、Trellis
spec 初始化,以及 `docs/refactor-plan.md` 的收尾处理。
2. 删除 `docs/refactor-plan.md`,因为它开头已声明 P3 收尾后应并入 changelog 并删除。
3. 更新 `.trellis/spec/guides/artifact-parity-guide.md` 中对 `docs/refactor-plan.md`
直接依赖,保留 parity/control 结论和 P0-P3 当前状态,但不引用已删除文件。
4. 不改业务代码,不改 Blender/Cesium 产物,不修 D1-D3。
5. 删除后不得留下指向 `docs/refactor-plan.md` 的断链引用。
## Acceptance Criteria
- [ ] `docs/refactor-plan.md` 不存在。
- [ ] `docs/changelog.md` 顶部有 2026-08-03 条目,记录 P3 完成和临时计划归档。
- [ ] `rg "docs/refactor-plan.md|refactor-plan" docs .trellis/spec README.md` 不再发现活文档引用。
- [ ] `git diff --check` 通过。
- [ ] 工作范围只包含 docs、`.trellis/spec` 和当前 Trellis task 文件。
## Out of Scope
- P2 要素注册表补完。
- D1/D2/D3 修复。
- 任何 `blender/``scripts/``config/` 业务代码改动。

View File

@@ -0,0 +1,30 @@
{
"id": "archive-refactor-plan",
"name": "archive-refactor-plan",
"title": "Archive refactor plan",
"description": "Move completed osmassets refactor-plan conclusions into changelog and remove the stale temporary plan.",
"status": "in_progress",
"dev_type": "docs",
"scope": "docs/spec",
"package": null,
"priority": "P2",
"creator": "dingkang",
"assignee": "dingkang",
"createdAt": "2026-08-03",
"completedAt": null,
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": null,
"relatedFiles": [
"docs/changelog.md",
"docs/refactor-plan.md",
".trellis/spec/guides/artifact-parity-guide.md"
],
"notes": "Lightweight docs cleanup. Remove stale temporary refactor plan after merging durable conclusions into changelog/spec.",
"meta": {}
}