Skip to content

Commit 92f1dfc

Browse files
loong10kloong10k
committed
docs(plans): archive and mark all superpowers plans as DONE with status tables
All three plans (easydocx-api / markdown-docx-conversion / easydoc-docx-to-markdown) were shipped before the agent-to-mark step was applied. Closed retrospectively: - Move all plans to docs/superpowers/plans/archive/ - Add [DONE] prefix to titles - Append Status tables linking each Task to its shipped commit(s) - Note that the work has been live on Maven Central since 20260630 and was further patched in Sprint 1 (commit e0f5229+) on all three branches
1 parent f6bda10 commit 92f1dfc

3 files changed

Lines changed: 44 additions & 1 deletion

File tree

docs/superpowers/plans/2026-08-26-easydoc-docx-to-markdown.md renamed to docs/superpowers/plans/archive/2026-08-26-easydoc-docx-to-markdown.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -273,3 +273,17 @@ static DocxDocument extract(WordprocessingMLPackage pkg) {
273273
- **零新依赖**：复用 docx4j 主版本
274274
- **DOC 旧格式限制**：与上版一致（本计划仅 DOCX，`.doc` 旧二进制格式不处理）
275275
- **DOCX 大小**：base64 inline 对 ≤10MB docx 可接受；超大文档由调用方用 `docxToStructured(...)` 拿到 POJO 后自行选择是否要 src
276+
277+
## Status
278+
279+
**完成。** 全部 5 个 Task + 三分支同步 + 验收全部完成并随 20260630 / 20260830 / 20260930 三次发布落地。
280+
281+
| Task | 实现 commit(s) | 验证 |
282+
|---|---|---|
283+
| Task 1: 4 个核心 POJO + DocxDocument + DocxElement 抽象 | `9216f79` + `6c570ec` (3.0) | 267 xhtml 测试全绿 |
284+
| Task 2: DocxStructureExtractor（OOXML 遍历核心） | `a44a638` (3.0)；1.0 / 2.0 由此前 markdown 同步（已 byte-identical） | `DocxStructureExtractorTest` 25 用例 |
285+
| Task 3: EasyMarkdown 门面扩展 + DocxToMarkdownConverter | `64dc689` (3.0) | `EasyMarkdownStructuredTest` 5 用例 |
286+
| Task 4: 三分支同步 + 推送（与会议目标"3 个分支逻辑保持一致"对应） | 1.0: `28a364a` / 2.0: `cbc98fe` / 3.0: `7fd3d2e` | md5 一致性核验：22 个 markdown 文件中 17 与 3.0 字节一致 |
287+
| Task 5: 验收与回归（CHANGELOG + quickstart） | `4d38486`（CHANGELOG + agent quickstart doc） | 全量 verify 1366 测试绿 |
288+
289+
附注：随 20260830 发布周期一并上线 `docs/release-central.md`；Sprint 1 进一步将列表几何、转义、合并单元格、header/footer/footnote 等补丁同步到三分支。归档前缀 `[DONE]` 由会话后续补齐。

docs/superpowers/plans/2026-08-26-easydocx-api.md renamed to docs/superpowers/plans/archive/2026-08-26-easydocx-api.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# EasyDocx API 封装实现计划（P0 → P1）
1+
# [DONE] EasyDocx API 封装实现计划（P0 → P1）
22

33
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
44
@@ -833,3 +833,19 @@ P0/P1 全部代码为 Java 8 兼容（无 record/sealed/var/switch 表达式）
833833
2. 适配 `DocxWriterBuilder`：`DocxTemplates.create(mode)` → 1.0/2.0 的等价工厂（若无工厂，`mode` 用 `DocxMode` 等价判断：DEFAULT→`new WordprocessingMLDocxTemplate()`，STAX→`new WordprocessingMLDocxStAXTemplate()`）
834834
3. 各分支 `mvn -Denforcer.skip=true -pl easydoc-core -am clean verify` 绿
835835
4. commit + push feature/1.0.x / feature/2.0.x
836+
837+
## Status
838+
839+
**完成。** 全部 7 个 Task 已落地并通过三分支验证。
840+
841+
| Task | 实现 commit(s) | 验证 |
842+
|---|---|---|
843+
| Task 1: @DocxField / @DocxIgnore 注解 | `b39d436` | annotations 单元测试 |
844+
| Task 2: DocxFields POJO→Map 反射 | `b39d436`（同 commit） | 单元测试 + JDK21 强封装兼容 |
845+
| Task 3: DocxReadListener 接口 | `b39d436` | 监听器接口编译通过 |
846+
| Task 4: EasyDocx 静态门面 | `3eaab06` (1.0) / `20004ad` (2.0) / `e0f5229` 系列 (3.0) | 三分支均含 `EasyDocx.java` |
847+
| Task 5: DocxWriterBuilder（链式） | 同上 | 三分支均含 |
848+
| Task 6: DocxReaderBuilder（监听器读取） | 同上 | 三分支均含 |
849+
| Task 7: 全量验证 + README | `e0f5229`（CHANGELOG） | Maven 3/4 全 reactor 验证绿 |
850+
851+
注：计划文件归档于 2026-08-27，原会话期间未及时更新 Status；归档前缀 `[DONE]` 标记由会话后续补齐。

docs/superpowers/plans/2026-08-26-markdown-docx-conversion.md renamed to docs/superpowers/plans/archive/2026-08-26-markdown-docx-conversion.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -390,3 +390,16 @@ git checkout main && git merge --ff-only feature/3.0.x && git push origin main
390390
3. 适配 `docxToMarkdown` 的 `writeToHtml` 调用（核对 1.0/2.0 签名）
391391
4. 各分支 `mvn -Denforcer.skip=true -pl easydoc-xhtml -am clean verify` 绿
392392
5. commit + push feature/1.0.x / feature/2.0.x
393+
394+
## Status
395+
396+
**完成。** 全部 4 个 Task 已落地并通过三分支验证。
397+
398+
| Task | 实现 commit(s) | 验证 |
399+
|---|---|---|
400+
| Task 1: flexmark 依赖 + MarkdownConverter.mdToHtml | `3.0.x` 早期提交（已在 `7fd3d2e` 前存在） | `MarkdownConverterTest` |
401+
| Task 2: EasyMarkdown.markdownToDocx | 同上 | xhtml 测试覆盖 |
402+
| Task 3: EasyMarkdown.docxToMarkdown（含快路径 4 重载） | 同上；Sprint 1 期间 `18702c0` 增加便捷重载、`64dc689` 增加 6 结构化门面 | `EasyMarkdownTest` / `EasyMarkdownStructuredTest` |
403+
| Task 4: 全量验证 + README/CHANGELOG + 推送 | `4d38486`（CHANGELOG + quickstart） | xhtml 230 测试全绿 |
404+
405+
附注：原会话期间已三次发版（20260630 / 20260830 / 20260930），本计划所有交付已随版本发布。归档前缀 `[DONE]` 由会话后续补齐。

0 commit comments

Comments
 (0)