用途
archify-review 用于审查 Archify 项目中的 issue、PR 或代码,帮助团队以证据为基础做出维护决策。它关注的核心问题是:某个问题是否值得处理,某种方案是否值得长期维护。适用场景包括 issue 分类、变更评审和代码质量评估。
主要能力
该审查从三个维度展开判断:
- 价值(Value):识别真正的问题是什么、谁会受益、问题发生频率如何、带来哪些后果,以及当前是否值得处理。
- 成本(Cost):考虑实现与验证所需的工作量,以及未来理解、修改和维护这些代码的成本。倾向于复用已有能力,并保持解决方案与问题规模相称。
- 影响(Impact):识别受影响的行为与模块、对用户和后续开发的影响,以及该变更是否提升可维护性,或是否引入耦合与约束。
在三个维度内,还会根据具体问题考虑可维护性、复杂度、兼容性、性能等相关关注点。
使用方式
审查以证据为基础:核实目标版本与相关事实,区分直接验证、已有证据与假设,并选择能够解决关键不确定性的检查方式。输出时会解释该工作是否值得推进、方案的成本与影响、是否存在更好的替代方案,以及影响决策的未决问题,并给出理由,按各关注点的重要性调整细节。
仓库特定的审查与贡献要求,可参考 REVIEWING.md 与 CONTRIBUTING.md。
适用场景
- issue 分类(issue triage)
- 变更评审(change reviews)
- 代码质量评估(code quality assessments)
限制
资料中未说明该工具的具体实现形式、安装命令、平台支持、收费方式或自动化程度,这些信息暂未提供。