briefbound-feature-reuse-research
Use when a new capability is not already implemented in the project and an existing library, project, standard, or example could replace writing it from scratch; do not use for bugs, styling, mechanic
SKILL.mdskills/engineering/briefbound-feature-reuse-research/SKILL.md
GitHubBriefbound Feature Reuse Research
目标
新能力在项目里还没有同样实现时,写代码前做只读复用研究:先查项目内,再查成熟库、官方示例和标准,评估复用、改造、只参考或自研。
本 skill 不写代码。结论清楚且不需要为依赖、架构或许可证拍板时,交回原开发 owner 实施;需要拍板时才交 briefbound-planning。
Briefbound task contract
- Context Boundary: 用户目标、当前项目可复用点、网络/本地搜索范围、排除范围、许可证和依赖边界。
- Output Contract: 结论清楚时一句话和证据;要新增依赖或许可证说不清时才给候选评估和复用决策。
- Allowed Action: 只读搜索和只读本地代码/文档检查;不安装依赖、不运行外部代码、不复制外部代码、不扩大用户未确认范围。
- Success Evidence: 项目内复用点已查,候选有链接或本地证据。结论清楚时原开发 owner 能直接接着写;需要拍板时决策足够让用户选择。
- Stop Condition: 研究产出复用决策即止;无法搜索、许可证不明、需求不清或复用会改变用户未确认范围时停止;试用/安装/复制外部代码移交原开发 owner 或按授权继续。
- Route Out: 原开发 owner、
briefbound-planning、继续复用研究、briefbound-router或 BLOCKED。
统一调用契约
- 只处理 Briefbound task contract 范围;不匹配时回
briefbound-router或更具体 owner,复合任务不吞其他 owner。 - 用户可见内容默认中文,完成只报状态、产出、证据和剩余风险;代码、命令、路径、错误原文、API/协议、skill 名和枚举保留原样;Route Out 仅以 Briefbound task contract 为准。结论清楚时用一句话交给原开发 owner 继续实现,不写候选表,也不写下一步建议。要新增依赖或许可证说不清时才展开比较,末行
下一步建议: <一个具体动作>,不交回可自行执行的步骤。
进入条件
新能力在项目内没有同样实现时就进入,写代码前先做 QUICK。不能联网时说明限制,只用本地依赖、文档和代码做降级研究。
不使用本 skill:
- 单点小改、样式调整、普通 bug 修复、机械重构、沿用项目已有模式;
- 用户明确要求从零实现;
- 功能高度私有,外部实现没有可比价值;
- 复用只会增加依赖、许可证、维护或集成负担。
研究范围
按功能类型选择 2-4 类来源,不要盲目铺开:
- 官方文档和官方示例:框架、SDK、协议、浏览器/API、平台能力。
- 包管理器生态:npm、PyPI、Cargo、Go modules、Maven、NuGet 等。
- GitHub 项目:相似产品、组件库、插件、参考实现、算法实现。
- 当前项目内复用:已有模块、工具函数、设计系统、服务接口、测试 helper。
- 标准/论文/规范:协议、格式、算法、互操作行为。
优先级:
- 当前项目已有可复用模块;
- 官方推荐库或官方示例;
- 活跃、许可证清晰、测试充分的成熟库;
- 可参考的开源项目设计;
- 自研。
默认先 QUICK:检查项目内复用点,再查看 2-4 个最相关的官方来源、成熟库或 GitHub 项目;决策已稳定就停止,不为凑候选扩大搜索。某个渠道没搜成要说明,不能写成没有现成实现。只有许可证、架构适配或关键能力仍无法判断时才进入 DEEP。
候选筛选
每个候选必须有明确价值,不凑数。最多保留 3-5 个候选。
候选字段:
- Name / Link:名称和来源链接;
- Capability Fit:覆盖目标功能的哪些部分;
- License:许可证是否允许当前项目使用;
- Activity:维护活跃度、近期提交、issue 状态、发布频率;
- Integration Cost:接入成本、依赖体积、框架/语言/运行时兼容;
- Adaptation Cost:需要改造的程度;
- Testability:是否容易写测试和验证;
- Project Fit:是否符合当前架构、代码风格、依赖边界和长期维护能力;
- Risk:供应链、弃维护、过度依赖、API 不稳定、性能或可扩展性风险。
如果找不到有价值候选,也要输出 BUILD_IN_HOUSE,并说明搜索证据和自研边界。
决策规则
输出一个主决策:
REUSE:直接引入库或模块,适合成熟、低集成成本、许可证清晰、测试充分。ADAPT:借用模块或局部实现思路,需要包装、裁剪或适配当前架构。REFERENCE_ONLY:只参考设计、API、数据结构、交互或测试思路,不引入依赖。BUILD_IN_HOUSE:自研,原因可能是需求特殊、候选不活跃、许可证不合适、集成成本高或依赖风险大。BLOCKED:无法搜索、许可证不明、需求不清或必须用户选择。
评估权重:
- 用户目标贴合度 > 当前项目适配度 > 维护活跃度 > 可测试性 > 集成成本 > 依赖体积。
- 不因为“有现成库”就默认复用;复用必须降低总体成本或风险。
- 不因为“能自研”就跳过研究;新能力必须说明查过什么、为什么不复用。
输出契约
结论清楚、不新增需要拍板的依赖、许可证也清楚时,只写一句:用什么、为什么、证据在哪。这句话交给原开发 owner,随实现继续,不另出候选表。
要新增依赖,或许可证、架构适配说不清时,才展开:
复用研究: 目标功能 / 搜索范围 / 当前项目已有复用点 / 结论(REUSE / ADAPT / REFERENCE_ONLY / BUILD_IN_HOUSE / BLOCKED)/ 推荐原因
候选评估: 每个候选按「候选字段」逐项给出依据,末行 Verdict: keep / reject;原因...
下一步建议: <只在要新增依赖或许可证说不清时写;结论清楚则省略>
质量门槛
- 必须给链接或本地证据;不能写“可能有库”“应该可以参考”。
- 进入原开发 owner 前带上这一句结论和证据,不重复研究。需要用户拍板时才进入
briefbound-planning。