Agent Skills › peach-mitao/peach › peach-reuse-first

peach-reuse-first

GitHub

规范Peach项目中代码复用的决策流程与实施边界,涵盖能力搜索、依赖选型验证、复杂度控制及交付标准,旨在减少重复造轮子并确保技术选型的合理性与合规性。

.claude/skills/peach-reuse-first/SKILL.md peach-mitao/peach

触发场景

新增或恢复功能时评估是否复用现有实现 引入外部协议、SDK或库前进行选型对比 处理抓取、媒体或基础设施能力时的架构决策

安装

npx skills add peach-mitao/peach --skill peach-reuse-first -g -y
更多选项

非标准路径

npx skills add https://github.com/peach-mitao/peach/tree/master/.claude/skills/peach-reuse-first -g -y

不安装直接使用

npx skills use peach-mitao/peach@peach-reuse-first

指定 Agent (Claude Code)

npx skills add peach-mitao/peach --skill peach-reuse-first -a claude-code -g -y

安装 repo 全部 skill

npx skills add peach-mitao/peach --all -g -y

预览 repo 内 skill

npx skills add peach-mitao/peach --list

SKILL.md

Frontmatter
{
    "name": "peach-reuse-first",
    "description": "新增、恢复或重写 Peach 功能、外部协议、抓取、媒体与基础设施能力时使用。"
}

复用与实现范围

最后复核:2026-10-26 证据来源:ADR-0010、docs/REUSE.md、FANBOX 与浏览器数据复用事故、用户确认的复杂度与调查停止条件。

选择路径

  1. 按能力搜索当前树、docs/REUSE.md;有证据缺口再查 Git 历史,不以旧文件名缺失判断能力不存在。
  2. 已有实现覆盖需求时直接复用,验证本次差异后停止调查;局部修复不自动触发外部依赖评选。
  3. 确需新基础能力时比较官方协议、SDK、维护中的库与系统能力;实际候选核对维护、许可、固定版本、平台兼容、体积与已知故障。
  4. API 定义不足以决定方案时才读候选源码,可用已安装的 opensrc,不把工具安装设成固定前置。
  5. 用无真实写入的最小 POC 验证会改变选型的约束。Cookie、token、查询凭据与真实内容不进入日志或公开文档。

成熟依赖覆盖基础能力时只保留 Peach 领域 policy 和 DTO;复用开源模型或算法固定 revision 并遵守许可。外部方案不满足已验证约束时保留自研,在 docs/REUSE.md 说明理由。

复杂度边界

  • 新兜底、重试、兼容或竞态分支须有可触达输入、失败结果与依据;无依据的理论分支默认省略,必要的范围扩展由用户决定。
  • 未知输入在负责的边界校验,内部沿用已成立的类型和契约;新信任边界仍须校验。失败与无结果分别表达,不用默认值伪造成功。
  • 单次使用的 helper 在表达独立概念或隔离复杂边界时才抽;注释说明非明显约束及后果。
  • 实体身份、跨来源绑定、凭据隔离、候选复核、任务语义与交互属于 Peach 差异;通用传输、解析、锁、媒体编解码与控件优先复用。

交付

新增依赖、首个消费者、行为验证、锁文件与复用记录同批提交,不提前引入未来消费者。报告采用实现、领域差异、关键拒绝理由与实证;没有新增选型时不重做整份调查。

版本历史

  • b9f4cd7 当前 2026-11-02 08:56

同 Skill 集合

.claude/skills/peach-issue-delivery/SKILL.md
.claude/skills/peach-batch-jobs/SKILL.md
.claude/skills/peach-context-rules/SKILL.md
.claude/skills/peach-cross-platform/SKILL.md
.claude/skills/peach-jav-cover-workflow/SKILL.md
.claude/skills/peach-ledger-write/SKILL.md
.claude/skills/peach-reference-evidence/SKILL.md
.claude/skills/peach-shell-commands/SKILL.md
.claude/skills/peach-surfaces/SKILL.md
.claude/skills/peach-web-ui/SKILL.md
.claude/skills/peach-worktree/SKILL.md

元信息

文件数
0
版本
b9f4cd7
Hash
3da11515
收录时间
2026-11-02 08:56

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-11-02 20:49
浙ICP备14020137号-1