opc/dev_harness
2
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 补充任务 #15 判断案例归档

ila
2026-08-16 19:39:33 +08:00
parent 864d81b515
commit db07f88c64
1 changed files with 16 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Task-15-%E5%BC%80%E6%BA%90%E5%BB%BA%E8%AE%BE%E5%9F%BA%E7%BA%BF%E8%AF%84%E4%BC%B0.-.md
+16 -9
@@ -11,7 +11,7 @@
## 背景与目标 ## 背景与目标
DevHarness 原有新项目初始化流程没有明确要求在从零开发前评估可复用的成熟开源项目。本任务增加最小的建设基线选择步骤，让 Agent 和负责人基于适配、许可证、安全、维护和总成本比较二次开发与从零开发。 DevHarness 原有新项目初始化流程没有明确要求在从零开发前评估可复用的成熟开源项目。本任务增加建设基线选择步骤和技术中立案例，让 Agent 和负责人基于适配、许可证、安全、维护和总成本比较二次开发与从零开发。
## 最终方案 ## 最终方案
@@ -19,15 +19,21 @@ DevHarness 原有新项目初始化流程没有明确要求在从零开发前评
- 技术方案确定前，优先评估功能与架构匹配、持续维护、许可证兼容且工程流程完善的开源项目。 - 技术方案确定前，优先评估功能与架构匹配、持续维护、许可证兼容且工程流程完善的开源项目。
- 固定检查功能架构、许可证、维护活跃度、安全与依赖、测试 CI 发布文档、定制总成本和上游策略。 - 固定检查功能架构、许可证、维护活跃度、安全与依赖、测试 CI 发布文档、定制总成本和上游策略。
- 明确“先评估”不等于“必须采用”；许可证、安全、架构或维护成本不合适时允许从零开发，并记录候选项目排除原因。 - 明确“先评估”不等于“必须采用”；许可证、安全、架构或维护成本不合适时允许从零开发，并记录候选项目排除原因。
- 采用开源基线时，在 Project-Profile 的“技术栈与运行环境”记录上游名称、仓库地址、基线版本或提交、许可证、保留能力、定制范围和升级策略；未确认取舍先进入首个技术方案工单。 - 采用开源基线时，在 Project-Profile 记录上游名称、仓库地址、基线版本或提交、许可证、保留能力、定制范围和升级策略；未确认取舍先进入首个技术方案工单。
- Harness 要求该章节和顺延后的关键步骤存在。 - 增加四个判断案例：
- 功能、许可证和工程流程匹配时优先完整二次开发；
- 项目成熟但许可证不兼容时否决；
- 功能相似但改造成本过高时不采用完整项目；
- 没有合适完整产品时，只复用经过评估的成熟框架或组件。
- 每个案例都给出结论、原因和需要记录的上游或排除证据。
- Harness 要求建设基线及判断案例小节存在。
- 未增加自动搜索、下载、克隆、依赖扫描或独立主题页面。 - 未增加自动搜索、下载、克隆、依赖扫描或独立主题页面。
## 修改文件 ## 修改文件
- `docs/07-new-project-documentation-setup.md`：线上 Wiki 的核心只读镜像，增加建设基线评估步骤。 - `docs/07-new-project-documentation-setup.md`：线上 Wiki 的核心只读镜像，增加建设基线评估和四个案例。
- `dev_scripts/check_harness.py`：要求建设基线章节和新编号存在。 - `dev_scripts/check_harness.py`：要求建设基线、判断案例和顺延后的关键步骤存在。
- `tests/test_harness_docs.py`：验证核心结构包含建设基线选择。 - `tests/test_harness_docs.py`：验证核心结构包含建设基线选择和判断案例。
## 验收结果 ## 验收结果
@@ -38,6 +44,7 @@ DevHarness 原有新项目初始化流程没有明确要求在从零开发前评
| 覆盖功能、许可证、维护、安全、工程质量、成本和上游策略 | 通过 | | 覆盖功能、许可证、维护、安全、工程质量、成本和上游策略 | 通过 |
| 不适合时允许从零开发并记录原因 | 通过 | | 不适合时允许从零开发并记录原因 | 通过 |
| 上游地址、版本、许可证、定制范围和升级策略可追溯 | 通过 | | 上游地址、版本、许可证、定制范围和升级策略可追溯 | 通过 |
| 四个技术中立案例均包含结论、原因和记录要求 | 通过 |
| 未增加自动引入第三方代码或新主题页面 | 通过 | | 未增加自动引入第三方代码或新主题页面 | 通过 |
| Wiki、核心镜像和 Harness 检查一致 | 通过 | | Wiki、核心镜像和 Harness 检查一致 | 通过 |
@@ -46,10 +53,10 @@ DevHarness 原有新项目初始化流程没有明确要求在从零开发前评
- `python dev_scripts/check_harness.py --strict`：通过。 - `python dev_scripts/check_harness.py --strict`：通过。
- `python -m unittest discover -s tests -v`：32 项全部通过。 - `python -m unittest discover -s tests -v`：32 项全部通过。
- `python dev_scripts/sync_wiki_docs.py --check`：13 个核心页面全部一致。 - `python dev_scripts/sync_wiki_docs.py --check`：13 个核心页面全部一致。
- 人工场景一：满足适配、许可证、安全、维护和成本条件时，结论为优先二次开发并记录上游策略。 - 人工场景覆盖：完整二次开发、许可证否决、改造成本否决、只复用框架或组件。
- 人工场景二：不存在合适基线或风险不可接受时，结论为允许从零开发并记录候选排除原因。 - **未验证部分**：未对具体第三方开源项目执行许可证、安全或代码审查；本任务只定义流程和判断案例，不选择实际依赖。
- **未验证部分**：未对具体第三方开源项目执行许可证、安全或代码审查；本任务只定义流程，不选择实际依赖。
## 相关提交 ## 相关提交
- `a959fc3` docs: evaluate open-source project baselines (#15) - `a959fc3` docs: evaluate open-source project baselines (#15)
- `fe99ca5` docs: add project baseline examples (#15)