Menu
文档整合与同步维护 Skill。当用户说"整理文档"、"合并文档"、"更新开发文档"、"同步文档和代码"时触发。扫描散落文档，整合到 .dev_doc/ 对应模块的规范路径，验证文档与代码一致性，更新模块 README 和 CHANGELOG。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Bug修复流程（代码定位→问题复现→问题修复→回归测试→提交完成）。触发：用户报告bug、报错、异常、或说"XX不工作"/"XX报错"/"XX有问题"/"修复XX"/"排查XX"/"XX挂了"/"XX崩了"/"修一下"/"debug"/"fix"，通常会指出文件/函数/错误信息（KeyError/TypeError/OOM/ModuleNotFoundError/堆栈/控制台错误/白屏）或线上事故（内存泄漏/连接池耗尽/间歇性失败/重启后报错）。不要用于：新功能开发（用ez-dev）、配置调整、纯文档编写、"xxx怎么用"问答、纯阅读理解代码、对话式咨询。核心原则：worktree开发、测试复现优先、用户手动merge。
生成每日开发进度总结报告。并行执行进度总结、任务更新、全量测试、文档整理，汇总成HTML报告。
完整功能开发流程（需求→设计→计划→TDD开发→测试→完成）。触发：用户提出明确的开发任务时——"开发X"/"实现X"/"添加X功能"/"新功能"/"做个新特性"/"重构X"/"修复X bug"。不要用于：单行修改、配置调整、纯文档编写、"xxx怎么用"问答、bug 原因排查、纯阅读/理解代码、对话式咨询。核心原则：worktree开发、独立Subagent审查、用户手动merge。
通用测试工程技能。提供测试用例生成、测试执行、报告生成的完整流程指导。触发条件：用户提及"测试"、"编写测试"、"test"、"测试报告"、"生成测试用例"、"执行测试"、"测试覆盖"、"单元测试"、"集成测试"时触发。**仅用于独立的测试工程任务**（如专门编写一个测试套件、跑一轮全量测试、分析覆盖率）；若是新功能开发流程中嵌套的测试编写由 `ez-dev` 触发；若是 bug 修复流程中的验证测试由 `bug_fix` 触发。
待办事项管理skilll。管理 todo.md 和 work_done.md为主的开发任务生命周期。当用户说"记录这个需求"、"帮我看看优先级"、"XX功能完成了"、"生成今日计划"、"看看今天该做什么"、"本周计划"、"本月计划"、"进度如何"时触发。也适用于：需要调整任务优先级、分析工作量、验证任务完成状态、整理待办事项。
"同步用户全局 skills 到 Git 仓库并发布。当用户说"同步skills"、"发布skills"、"更新skills到github"、"sync skills"时触发。**本 skill 只同步用户全局 skills（~/.claude/skills/），不同步项目内的 skills（项目 .claude/skills/ 目录）。**负责将全局 skills 同步到 dev_toolkits 仓库，并打包 .skill 文件发布 Release。"
| name | doc_integrate |
| description | 文档整合与同步维护 Skill。当用户说"整理文档"、"合并文档"、"更新开发文档"、"同步文档和代码"时触发。扫描散落文档，整合到 .dev_doc/ 对应模块的规范路径，验证文档与代码一致性，更新模块 README 和 CHANGELOG。 |
相关模块合并到统一路径。
vector-schema-sync + vector-store-async-query → vector_store/extra_function/utils/vector_stores → vector_store/相似功能整合到一个文档中，避免同一模块功能分散在多个 design.md。
已完成模块（Phase >= 6）的 design/plan/status 文档合并到模块 README。
模块/README.md 章节模块/CHANGELOG.md模块应在规范路径下，不在临时 feature 目录。
vector_store/ ✅vector-schema-sync/ ❌ 临时目录，应清空合并仍在开发的模块（Phase < 6）暂时不处理，等完成后再合并。
每个模块子目录下只保留两个文件：
README.md：记录模块架构、使用方法CHANGELOG.md：记录所有历史变更（包括已废除内容）其他内容全部整合到上述两个文件。
| 散落文档 | 归属 |
|---|---|
test_fix_plan.md | database/ |
excel-test-case-library-plan.md | database/ |
项目代码优化修改.md | 已完成→CHANGELOG，未完成→README |
text2sql_skill_suite_design.md | database/ |
.dev_doc/ 根目录的日期前缀文档（YYYY-MM-DD-*.md）.dev_doc/<feature>/）必须扫描所有子目录，确保不遗漏任何文档。
对每份提到具体代码文件的文档：
每个子目录下只保留 README.md 和 CHANGELOG.md：
# 文档整合报告 - YYYY-MM-DD
## 整合统计
| 状态 | 数量 |
|------|------|
| 已整合到模块 README | X |
| 已删除 | X |
| 保留在根目录（可能需要开发） | X |
## 子目录清理
- ✅ vector_stores/：只保留 README.md, CHANGELOG.md
- ✅ database/：只保留 README.md, CHANGELOG.md
...
.dev_doc/
├── architecture.md ← 根目录核心文档
├── vector_stores/
│ ├── README.md ← 架构、使用方法
│ └── CHANGELOG.md ← 历史变更记录
├── data_process/
│ ├── README.md
│ └── CHANGELOG.md
└── <feature>/ ← ez-dev 临时目录，完成后清空
任何不在规范路径的文档都是待整理对象。
# 模块名
## 概述
一句话描述模块作用。
## 架构
模块整体结构和核心组件。
## 使用方法
### 初始化
```python
from module import ClassName
method_name(param)描述方法作用。
参数：
param (type): 参数描述返回： 返回值类型和含义
示例：
result = method_name("input")
相关配置项说明。
子模块作用和用法。
## 标准 CHANGELOG 格式
```markdown
# 模块名 CHANGELOG
## [未整合] YYYY-MM-DD
### 文档变更
- 合并 `原文档名` 到 README §章节名
- 删除 `原文档名`：原因
### 代码变动
- `文件路径`
- 变更描述
### 同步记录
- 文档与代码不一致处已修正：修正内容
关键结构：
| 区域 | 内容 |
|---|---|
| 概述 | 一句话，不超过两行 |
| 架构 | 组件关系，用文字或代码块描述 |
| 使用方法 | 按初始化→核心接口→配置→子模块顺序 |
| CHANGELOG | 每条变更带日期，包括已删除/废除记录 |