4

Task-15-开源建设基线评估

ila edited this page 2026-08-16 19:46:39 +08:00

Table of Contents

• 15 开源建设基线评估
• 背景与目标
• 最终方案
• 修改文件
• 验收结果
• 测试
• 相关提交

15 开源建设基线评估

• 类型：需求
• 所属 Epic：无
• 所属 MVP / 版本：无
• 状态：已完成
• 日期：2026-08-16
• 验收日期：2026-08-16
• 验收结果：用户明确验收通过
• Gitea 工单：#15
• Wiki 页面：Task-15-开源建设基线评估
• Wiki revision：以线上页面当前 revision 为准

背景与目标

新项目初始化流程原来没有明确要求在从零开发前评估成熟开源项目。本任务增加建设基线选择步骤和技术中立案例，让 Agent 和负责人比较二次开发与从零开发。

最终方案

• 技术方案确定前，优先评估功能架构、维护、许可证、安全、工程流程和总成本。
• “先评估”不等于“必须采用”；不合适时允许从零开发并记录排除原因。
• 采用开源基线时记录上游仓库、基线版本、许可证、定制范围和升级策略。
• 增加完整二次开发、许可证否决、改造成本否决、只复用框架或组件四个案例。
• Harness 固定检查建设基线和判断案例小节。
• 未增加自动搜索、下载、依赖扫描或独立页面。

修改文件

• docs/07-new-project-documentation-setup.md：增加建设基线评估和四个案例。
• dev_scripts/check_harness.py：检查建设基线和案例章节。
• tests/test_harness_docs.py：验证核心结构。

验收结果

验收标准	结果
包含建设基线评估步骤	通过
优先评估而非强制采用	通过
覆盖许可证、安全、维护、工程质量和成本	通过
不适合时允许从零开发	通过
四个案例包含结论、原因和记录要求	通过
用户验收	通过

测试

• 严格检查：通过。
• 单元测试：32 项全部通过。
• 核心镜像检查：13 个页面全部一致。
• 人工场景覆盖完整二次开发、许可证否决、改造成本否决和只复用框架或组件。
• 未验证部分：未评估具体第三方项目；本任务只定义流程和案例。

相关提交

• a959fc3 docs: evaluate open-source project baselines (#15)
• fe99ca5 docs: add project baseline examples (#15)