docs: 记录任务 #15 验收通过
@@ -3,58 +3,51 @@
|
|||||||
- 类型:需求
|
- 类型:需求
|
||||||
- 所属 Epic:无
|
- 所属 Epic:无
|
||||||
- 所属 MVP / 版本:无
|
- 所属 MVP / 版本:无
|
||||||
- 状态:待验收
|
- 状态:已完成
|
||||||
- 日期:2026-08-16
|
- 日期:2026-08-16
|
||||||
|
- 验收日期:2026-08-16
|
||||||
|
- 验收结果:用户明确验收通过
|
||||||
- Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/15
|
- Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/15
|
||||||
- Wiki 页面:Task-15-开源建设基线评估
|
- Wiki 页面:Task-15-开源建设基线评估
|
||||||
- Wiki revision:以线上页面当前 revision 为准
|
- Wiki revision:以线上页面当前 revision 为准
|
||||||
|
|
||||||
## 背景与目标
|
## 背景与目标
|
||||||
|
|
||||||
DevHarness 原有新项目初始化流程没有明确要求在从零开发前评估可复用的成熟开源项目。本任务增加建设基线选择步骤和技术中立案例,让 Agent 和负责人基于适配、许可证、安全、维护和总成本比较二次开发与从零开发。
|
新项目初始化流程原来没有明确要求在从零开发前评估成熟开源项目。本任务增加建设基线选择步骤和技术中立案例,让 Agent 和负责人比较二次开发与从零开发。
|
||||||
|
|
||||||
## 最终方案
|
## 最终方案
|
||||||
|
|
||||||
- New-Project-Documentation-Setup 在项目边界之后增加“选择建设基线”。
|
- 技术方案确定前,优先评估功能架构、维护、许可证、安全、工程流程和总成本。
|
||||||
- 技术方案确定前,优先评估功能与架构匹配、持续维护、许可证兼容且工程流程完善的开源项目。
|
- “先评估”不等于“必须采用”;不合适时允许从零开发并记录排除原因。
|
||||||
- 固定检查功能架构、许可证、维护活跃度、安全与依赖、测试 CI 发布文档、定制总成本和上游策略。
|
- 采用开源基线时记录上游仓库、基线版本、许可证、定制范围和升级策略。
|
||||||
- 明确“先评估”不等于“必须采用”;许可证、安全、架构或维护成本不合适时允许从零开发,并记录候选项目排除原因。
|
- 增加完整二次开发、许可证否决、改造成本否决、只复用框架或组件四个案例。
|
||||||
- 采用开源基线时,在 Project-Profile 记录上游名称、仓库地址、基线版本或提交、许可证、保留能力、定制范围和升级策略;未确认取舍先进入首个技术方案工单。
|
- Harness 固定检查建设基线和判断案例小节。
|
||||||
- 增加四个判断案例:
|
- 未增加自动搜索、下载、依赖扫描或独立页面。
|
||||||
- 功能、许可证和工程流程匹配时优先完整二次开发;
|
|
||||||
- 项目成熟但许可证不兼容时否决;
|
|
||||||
- 功能相似但改造成本过高时不采用完整项目;
|
|
||||||
- 没有合适完整产品时,只复用经过评估的成熟框架或组件。
|
|
||||||
- 每个案例都给出结论、原因和需要记录的上游或排除证据。
|
|
||||||
- Harness 要求建设基线及判断案例小节存在。
|
|
||||||
- 未增加自动搜索、下载、克隆、依赖扫描或独立主题页面。
|
|
||||||
|
|
||||||
## 修改文件
|
## 修改文件
|
||||||
|
|
||||||
- `docs/07-new-project-documentation-setup.md`:线上 Wiki 的核心只读镜像,增加建设基线评估和四个案例。
|
- `docs/07-new-project-documentation-setup.md`:增加建设基线评估和四个案例。
|
||||||
- `dev_scripts/check_harness.py`:要求建设基线、判断案例和顺延后的关键步骤存在。
|
- `dev_scripts/check_harness.py`:检查建设基线和案例章节。
|
||||||
- `tests/test_harness_docs.py`:验证核心结构包含建设基线选择和判断案例。
|
- `tests/test_harness_docs.py`:验证核心结构。
|
||||||
|
|
||||||
## 验收结果
|
## 验收结果
|
||||||
|
|
||||||
| 验收标准 | 结果 |
|
| 验收标准 | 结果 |
|
||||||
|---|---|
|
|---|---|
|
||||||
| 新项目初始化包含“选择建设基线” | 通过 |
|
| 包含建设基线评估步骤 | 通过 |
|
||||||
| 优先评估而非强制采用开源项目 | 通过 |
|
| 优先评估而非强制采用 | 通过 |
|
||||||
| 覆盖功能、许可证、维护、安全、工程质量、成本和上游策略 | 通过 |
|
| 覆盖许可证、安全、维护、工程质量和成本 | 通过 |
|
||||||
| 不适合时允许从零开发并记录原因 | 通过 |
|
| 不适合时允许从零开发 | 通过 |
|
||||||
| 上游地址、版本、许可证、定制范围和升级策略可追溯 | 通过 |
|
| 四个案例包含结论、原因和记录要求 | 通过 |
|
||||||
| 四个技术中立案例均包含结论、原因和记录要求 | 通过 |
|
| 用户验收 | 通过 |
|
||||||
| 未增加自动引入第三方代码或新主题页面 | 通过 |
|
|
||||||
| Wiki、核心镜像和 Harness 检查一致 | 通过 |
|
|
||||||
|
|
||||||
## 测试
|
## 测试
|
||||||
|
|
||||||
- `python dev_scripts/check_harness.py --strict`:通过。
|
- 严格检查:通过。
|
||||||
- `python -m unittest discover -s tests -v`:32 项全部通过。
|
- 单元测试:32 项全部通过。
|
||||||
- `python dev_scripts/sync_wiki_docs.py --check`:13 个核心页面全部一致。
|
- 核心镜像检查:13 个页面全部一致。
|
||||||
- 人工场景覆盖:完整二次开发、许可证否决、改造成本否决、只复用框架或组件。
|
- 人工场景覆盖完整二次开发、许可证否决、改造成本否决和只复用框架或组件。
|
||||||
- **未验证部分**:未对具体第三方开源项目执行许可证、安全或代码审查;本任务只定义流程和判断案例,不选择实际依赖。
|
- **未验证部分**:未评估具体第三方项目;本任务只定义流程和案例。
|
||||||
|
|
||||||
## 相关提交
|
## 相关提交
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user