ZH

---
name: docs-analysis
version: 1.0.0
type: skill
author: Lukas Geiger
created: 2026-03-15
updated: 2026-03-15
description: 文档需求分析：分析 docs/ 文件夹中的概念与需求文档，针对当前代码检查需求，并生成整合的差异报告。

standalone: true
anthropic_compatible: true
bach_compatible: false
bach_origin: true
category: dev
tags: [docs-analysis, requirements, code-review, diff-report, quality-assurance]
language: zh
status: active
dependencies: {'tools': [], 'services': [], 'protocols': [], 'python': []}
provenance: {'origin': 'bach', 'origin_path': 'system/skills/workflows/docs-analyse.md', 'origin_version': '1.2.0', 'origin_repo': 'github.com/ellmos-ai/bach', 'last_sync_from_origin': '2026-03-15', 'last_sync_to_origin': None, 'local_changes_since_sync': True}
---

<img src="../banner.png" width="100%" alt="docs-analysis banner">

> **中文** — `docs-analysis` 官方中文版本。


# 文档需求分析 (中文)

> 分析所有概念与需求文档，针对当前代码检查其需求，并生成整合的差异报告。

---

## 概述与目的

分析 ../docs/ 文件夹中的所有概念与需求文档，针对当前代码检查其需求，并生成整合的差异报告。

---

## 命名规范

### 前缀与后缀
所有经分析的文档将包含：
- **前缀：** `conN_`，其中 N = 分析版本（1, 2, 3, ...）
- **后缀：** `_XX`，其中 XX = 完成百分比（四舍五入至最接近的 10）

### 归档阈值
- **>= 75% 已完成：** 文档将被移动至 `../docs/_archive/`
- **< 75% 已完成：** 文档保留在 `../docs/` 中并带有前缀/后缀
- **阈值可配置**（默认值：75）

---

## 流程

### 阶段 1：收集文档
- 列出 ../docs/（根目录）中的所有 *.md 和 *.txt 文件
- 过滤掉 README.txt

### 阶段 2：提取需求
针对每个文档：
- 读取内容
- 识别需求（检查清单、表格、MISSING/TODO 标记）
- 分类：Structure、Code、API、DB Schema、CLI、Feature

### 阶段 3：代码验证
针对各项需求：
- 确定验证方法（Glob、Grep、Read）
- 执行验证
- 标记为：FULFILLED、PARTIAL、MISSING

### 阶段 4：评估
- 统计已完成与未完成的需求
- 计算完成百分比 (%)
- 决定：归档 (>= 75%) 或保留 (< 75%)

### 阶段 5：生成输出
- 创建 REQUIREMENTS_ANALYSIS.md（摘要）
- 创建 consense_diff.md（仅未完成需求，按优先级排列）

### 阶段 6：版本控制
- 扫描最高 conN_ 前缀
- 新版本 = 最高版本 + 1

### 阶段 7：重命名与移动
- 对文档应用新的前缀/后缀
- 归档或保留

---

## 输出

| 文件 | 描述 |
|------|------|
| `conN_REQUIREMENTS_ANALYSIS.md` | 完整分析（版本 N） |
| `consense_diff_N.md` | 整合的未完成需求 |
| `_archive/conN_*_XX.*` | 已归档 (>=75%) 的文档 |

---

## 优先级分类

| 优先级 | 判定标准 |
|:------:|----------|
| P1 | 核心功能缺失，系统无法使用 |
| P2 | 重要特性缺失，但存在变通方案 |
| P3 | 锦上添花，改善用户体验 (UX) |
| P4 | 外观细节、文档、代码质量 |

---

## 变更日志

### 1.0.0 (2026-03-15)
- 从 BACH v3.8.0 移植

---

*从 BACH v3.8.0 移植 | 独立版本*