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:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user