Codex Chan 代码架构评审|把仅内部使用的接口收窄
EnglishCodex 安装步骤
- 打开 GitHub 固定提交的 `.agents/skills/architect/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.agents/skills/architect/`,把核对后的文件保存为 `.agents/skills/architect/SKILL.md`。
- 在该项目根目录启动 Codex,输入 `$architect` 并选择同名技能。
中文摘要
按 Chan 的架构评审要点检查公共接口、对象职责和重复逻辑,确认共享逻辑确有共同意图并且依赖保持清楚。
SKILL.md 中文导读
可复现示例
根据下面的演示差异评审辅助函数的暴露范围。
{"helper":"formatLocalLabel","callers":["renderPreview","renderList"],"allCallersWithinModule":true,"proposedVisibility":"public"}工作步骤
- 核对公开入口的实际调用方和职责。
- 比较重复逻辑是否承担同一职责。
- 列出能收窄接口或复用现有辅助方法的修改。
验收方法
将 `formatLocalLabel` 保持为 `module-private`,由本模块里的调用方复用,并核对两处输出。
GitHub 原文 · 更新日期
适用环境
在 Codex 中打开 Chan 项目,准备差异、公共入口、相关调用方和受影响的测试。
常见问题
两段代码写法类似就应该合并吗?
先判断它们是否承担相同职责。意图相同且复用能降低维护成本时再抽取。