docs: 重构 README.md 和 SKILL.md,明确文档职责

- README.md 面向开发者:添加项目概述、核心概念说明、开发指南
- SKILL.md 面向 AI:强化 --advice 作为首选方案,明确三路径执行优先级
- 更新 specs:skill-documentation 和 uv-with-dependency-management
- README 添加 reportlab 测试依赖
This commit is contained in:
2026-03-09 21:56:58 +08:00
parent 9abc0a0707
commit 25d748aa17
4 changed files with 211 additions and 209 deletions

View File

@@ -7,12 +7,12 @@
## Requirements
### Requirement: 文档驱动的依赖声明
系统必须在 SKILL.md 和 README.md 中明确说明每种文档格式和平台所需的依赖包。
系统必须在 SKILL.md 和 README.md 中明确说明每种文档格式和平台所需的依赖包。README.md 面向开发者提供开发和测试的命令示例SKILL.md 面向 AI强调 --advice 优先。
#### Scenario: SKILL.md 包含完整的依赖命令
#### Scenario: SKILL.md 强调 --advice 而非完整命令
- **WHEN** AI 或用户阅读 SKILL.md
- **THEN** 文档必须为每种文档格式DOCX/XLSX/PPTX/PDF/HTML和平台提供完整的 `uv run --with` 命令示例
- **AND** 命令必须包含所有必需的依赖包
- **THEN** 文档引导使用 --advice 获取准确命令,不提供完整的 `uv run --with` 命令
- **AND** 仅保留简洁的参数使用示例
#### Scenario: README.md 包含开发依赖速查表
- **WHEN** 开发者阅读 README.md