feat(doc): 新增 DOCX 转 Markdown Skill
This commit is contained in:
zhiye.sun
+34
-18
@@ -36,6 +36,8 @@
|
||||
|
||||
## 4. 迁移批次
|
||||
|
||||
迁移分为“特殊样本”和“同质批量”两个阶段。前者用于覆盖迁移机制的不同风险类型，后者在规则稳定后提高吞吐量。批次数量不固定：特殊样本原则上逐个迁移，批量阶段每批建议 6～12 个同质 Skill。
|
||||
|
||||
### 第 0 批：迁移基础设施
|
||||
|
||||
第 0 批属于仓库内部维护工具，不发布为市场 Skill：
|
||||
@@ -47,29 +49,41 @@
|
||||
|
||||
完成门槛：能够对全部来源 Skill 生成稳定清单，并在不复制来源内容的情况下更新状态。
|
||||
|
||||
### 第 1 批：低风险样板
|
||||
### 第 1 阶段：特殊样本
|
||||
|
||||
先完成唯一标准样板，再按插件推进，避免一次跨模块迁移导致集中返工：
|
||||
特殊样本不追求模块连续性，而是覆盖不同迁移机制：
|
||||
|
||||
1. `doc/format-md`
|
||||
2. `doc/report`、`doc/requirements`
|
||||
3. `git/commit-msg`
|
||||
4. `knowledge/handoff`
|
||||
1. `doc/format-md`：纯指令型样本，已完成。
|
||||
2. `doc/docx-to-md`：多来源合并、脚本、依赖和生成物样本，已完成。
|
||||
3. `git/commit-msg`：只读 Git 状态分析样本。
|
||||
4. `git/branch`：修改仓库状态和二次授权边界样本。
|
||||
5. `knowledge/handoff`：模板化文档与项目上下文样本。
|
||||
6. `skill/guidance`：大型参考资料、索引和渐进式加载样本。
|
||||
7. `skill/migrate`：脚本、检查、同步和状态追踪组成的复合工作流样本。
|
||||
|
||||
完成门槛：`doc/format-md` 固化目录模板、验证命令、行为用例和迁移记录格式后，才能继续本批其余 Skill。
|
||||
完成门槛：每种样本均通过对应验证，并形成可复用的命名、目录、独立实现、测试、扫描和状态同步规则。出现未覆盖的新结构或权限类型时，应补充样本，不直接扩批。
|
||||
|
||||
### 第 2 批：文档转换
|
||||
### 第 2 阶段：同质批量迁移
|
||||
|
||||
特殊样本完成后，按同一插件、相近能力和相同风险类型组织批量迁移：
|
||||
|
||||
- 每批建议 6～12 个 Skill，高度同质时可以整组处理。
|
||||
- 不把只读能力与有副作用能力、纯指令与复杂脚本、普通迁移与公开资料重建强行合为一批。
|
||||
- 每批仍需迁移前确认和提交前确认，并统一更新 README、迁移计划和来源状态。
|
||||
- 任一验收门禁失败时暂停该批，不继续扩大范围。
|
||||
|
||||
### 文档转换批次
|
||||
|
||||
所属插件：`doc`
|
||||
|
||||
1. `docx-to-markdown`
|
||||
1. `docx-to-md`
|
||||
2. `markdown-to-docx`
|
||||
3. `excel-to-markdown`
|
||||
4. `archive-docs`
|
||||
|
||||
重点验证图片、表格、合并单元格、编码、覆盖策略和路径安全。脚本及测试数据必须独立创建。
|
||||
|
||||
### 第 3 批：Git 工作流
|
||||
### Git 工作流批次
|
||||
|
||||
所属插件：`git`
|
||||
|
||||
@@ -78,9 +92,9 @@
|
||||
3. `export-changes`
|
||||
4. `integrate-branch`
|
||||
|
||||
`summarize-commit` 已在样板批次完成。涉及提交、合并和远端操作的 Skill 必须保留明确授权边界，并保护脏工作区。
|
||||
`commit-msg` 将作为只读 Git 特殊样本先行完成。涉及提交、合并和远端操作的 Skill 必须保留明确授权边界，并保护脏工作区。
|
||||
|
||||
### 第 4 批：知识管理
|
||||
### 知识管理批次
|
||||
|
||||
所属插件：`knowledge`
|
||||
|
||||
@@ -92,7 +106,7 @@
|
||||
|
||||
来源中与经验初始化、提升和回扫相关的多个能力统一合并为 `maintain-lessons`，通过模式区分具体工作。
|
||||
|
||||
### 第 5 批：开发主流程
|
||||
### 开发主流程批次
|
||||
|
||||
所属插件：`dev`
|
||||
|
||||
@@ -119,7 +133,7 @@ plan-change
|
||||
|
||||
多个来源中的代码检查、代码审查能力合并为 `review-code`，通过工作区、提交和分支三种模式覆盖。
|
||||
|
||||
### 第 6 批：项目规范与前端辅助
|
||||
### 项目规范与前端辅助批次
|
||||
|
||||
1. `dev/select-component`
|
||||
2. `dev/design-style`
|
||||
@@ -129,7 +143,7 @@ plan-change
|
||||
|
||||
这里只实现读取和维护“当前项目自身规范”的机制，不随 CraftKit 提供任何来源项目规范。
|
||||
|
||||
### 第 7 批：基于公开资料重建
|
||||
### 基于公开资料重建批次
|
||||
|
||||
以下能力不从来源文本改写，而是根据官方资料重新设计：
|
||||
|
||||
@@ -142,7 +156,7 @@ plan-change
|
||||
|
||||
中性规格必须记录所采用的公开标准、官方文档和许可证信息。
|
||||
|
||||
### 第 8 批：暂缓或排除
|
||||
### 暂缓或排除
|
||||
|
||||
默认排除：
|
||||
|
||||
@@ -170,7 +184,7 @@ plan-change
|
||||
| 多套前端设计 | `design-frontend` |
|
||||
| 多套后端实现 | `implement-backend` |
|
||||
| 多套前端实现 | `implement-frontend` |
|
||||
| 多套 Word 转 Markdown | `docx-to-markdown` |
|
||||
| 多套 Word 转 Markdown | `docx-to-md` |
|
||||
| 经验初始化、提升、回扫 | `maintain-lessons` |
|
||||
| 规范检索和索引维护 | `retrieve-guidance`、`maintain-guidance` |
|
||||
|
||||
@@ -211,4 +225,6 @@ plan-change
|
||||
- [x] 实现 Skill 与敏感内容检查脚本。
|
||||
- [x] 实现迁移台账预览和更新脚本。
|
||||
- [x] 迁移并验证首个样板 `doc/format-md`。
|
||||
- [ ] 样板通过后推进第 1 批其余 Skill。
|
||||
- [x] 迁移并验证脚本型特殊样本 `doc/docx-to-md`。
|
||||
- [ ] 完成其余特殊样本并总结批量迁移规则。
|
||||
- [ ] 按插件和风险类型推进同质批量迁移。
|
||||
|
||||
Reference in New Issue
Block a user