replica-skill

一个想"抄"产品的人，和一套把抄变成流程的技能包

想象一个具体的场景。独立开发者小林看中了一款日程预约 App——用户发个链接，别人选时间约上会议。传统做法是打开 Figma 画界面、翻文档猜数据库、写到一半发现漏了改期流程，然后花三周时间交付一个"差不多"的壳子。

Jakeschincariol 的 replica-skill 想解决的就是这个断层。它不是又一个 AI 编程工具，而是一套 11 个串成流水线的 Claude Skills：/replica-recon → /replica-architect → /replica-design → /replica-build → /replica-backend → /replica-test → /replica-diff → /replica-entrepreneur → /replica-brand → /replica-launch → /replica-deploy。每个技能读上一个技能写下的文件，把手工作坊式的"复刻一个 App"拆成了可交接、可复用的 11 道工序。

截至 2026 年 11 月初，这个仓库在 GitHub 上收获 7160 star、1272 fork，MIT 协议，仓库体积仅 66KB。热度来自一个很朴素的诉求：独立开发者和产品经理需要一条从"我想做类似的东西"到"我上线了"的确定性通路。

背景：把"逆向竞品"从灰色地带拉回工程规范

这套技能包的作者把整条流水线建立在一条边界声明上："重建一个 App 做了什么，永远不重建它拥有什么。"

具体拆开是四层规则。第一层是洁净室（clean-room）——研究目标应用的功能与用户动线，但所有代码、文案、素材从零写；README 里明确禁止"view source and adapt"。第二层是只读合法来源——只读公开页面、应用商店listing、帮助中心和用户自己的账号，禁止绕过登录、抓取付费墙内容或调用对方的私有 API。第三层是强制换牌——/replica-brand 之后必须换新名字、新配色、新 logo、新文案。第四层是机器化的执行：sweep.py 会扫描整个代码库（包括 OriginalAppEmbed 这类标识符内部）找出原应用的名称、域名与残留色值，清理不干净，/replica-deploy 就不允许发布。

这个设计并非纸上谈兵。技能包里还内置了风险自述：它承认功能本身也可能受专利、商业外观（trade dress）和服务条款保护，并写明"涉及真金白银时请咨询律师，这不是法律建议"。在 AI 辅助编程的合规灰区里，这种把边界写进工具代码而非只写进 README 的做法，恰恰是它区别于多数"一键复刻"宣传的原因。

类比：像一份给 AI 的标准作业流程书

如果把 Claude Code 当成一个刚入职、能力很强但完全不知道你们公司流程的实习生，replica-skill 就是给他的一本《作业指导书》——只不过这份指导书的每一章都带着"上一章的产出是什么、这一章要交什么"的接口约定。

具体说，replica-recon 的产出是 replica/recon.md（页面清单、用户流程、组件、推断出的数据模型）加一张 replica/features.csv 功能矩阵；replica-architect 读这两份东西产出 architecture.md；replica-design 把截图量成设计 token；replica-build 一屏一屏地建，边建边在 features.csv 上打勾；replica-diff 最后用 parity.py 打分，must/should/could 三档加权，部分完成算一半。

有意思的是它"读什么、留什么"的界定：按钮的行为可以照搬（parity），按钮上的句子不行（copying）；设计系统里的色彩角色、间距节奏可以重建，logo、插画、专有字体必须换开源替代品（Lucide、Phosphor、Heroicons、Tabler）。这套"功能可复刻、表达须原创"的切分，比大多数同类项目讲得更细。

核心功能：11 个技能 + 6 个零依赖 Python 工具

技能侧。 每个 SKILL.md 都是标准 Anthropic Skill 格式，带 YAML frontmatter 的 name / description 触发词说明。replica-recon 支持从公开页面、截图、商店 listing、帮助文档和你自己的账号出发做侦察；replica-architect 默认选 Next.js(App Router) + Postgres + Stripe + Resend 这套"无聊但托管"的技术栈，还会在 schema 里写下"两个客人在同一时段永远不能重复预约"这样的约束；replica-test 从流程生成测试计划并产出 Playwright 规格，覆盖时区、预约中途被抢、重复提交等边界；replica-entrepreneur 读 App Store、G2、Capterra、Reddit 上的真实评论，把"用户最讨厌什么"排成修复计划。

工具侧。 6 个 Python 脚本全部只用标准库，不联网、不需要 pip install，只要 Python 3.8+：

工具	作用	设计巧思
imgdiff.py	纯标准库读 PNG，做边缘图比对输出布局差异	忽略颜色差异，所以换牌不会扣分
parity.py	读 features.csv 算功能对标分，列出缺失项	must 项缺失直接判定"不可发布"
reviews.py	把评论聚类成主题，按数量排序并附原文链接	无链接的评论直接丢弃；主题少于3条或单来源标记为"样本薄"
contrast.py	按 WCAG 比值检查设计 token 的文字对比度	把无障碍检查前置到设计阶段
sweep.py	全库扫描原应用名称、域名、配色残留	清理不干净就阻断部署
listing.py	校验 App Store / Google Play 上架限制	检查标题排名宣称、关键词浪费字符、是否出现原名

测试。 tests/ 目录下每个工具都有对应测试，python3 -m unittest discover -s tests -v 可运行，这在一个"一次提交、纯提示词"的仓库里是少见的严谨。

上手门槛：三条路，成本差异很大

项目提供了三条使用路径，成本递减：

1. Claude Code 插件（功能最全）

/plugin marketplace add Jakeschincariol/replica-skill
/plugin install replica-skill@replica-skill

注意 Claude Code 会给插件技能加命名空间前缀，实际调用是 /replica-skill:replica-recon；想用干净的 /replica-recon，直接 git clone 后把 replica-* 目录复制到 ~/.claude/skills/ 即可。

2. 直接复制文件夹（推荐）

git clone https://github.com/Jakeschincariol/replica-skill.git
cp -r replica-skill/replica-* ~/.claude/skills/

也可以复制进项目的 .claude/skills/ 做项目级隔离。

3. 纯对话模式（零门槛但有折损） 把任意一份 SKILL.md 粘到聊天框顶部，它会作为一种"模式"运行——方法论照样生效，但 Python 工具全部用不了，因此 parity.py 打分、sweep.py 清残留这些硬约束失效。

环境要求：Python 3.8+，无外部依赖，无需 GPU，无需 API key，无需注册任何服务。仓库体积 66KB，这是"轻"到极致的设计。

争议与局限：这个仓库还没有被充分验证

有几个问题不该被 star 数掩盖。

第一，成熟度存疑。 项目 2026 年 10 月 3 日创建，仓库历史只有一次提交，此后未再更新。在一个月内从零涨到 7000+ star 的同时，也意味着没有任何迭代修复记录可查。第三方测评（explainx.ai）也直接给出 "treat as early" 的判断。

第二，法律边界是产品的一部分，不是免责声明。 README 的 "Fine print" 写得很克制，但克制本身说明作者知道风险真实存在：功能本身受专利保护、商业外观权、服务条款都可能构成障碍。作者给出的唯一建议是"上线前查商标、做律师咨询"——把合规责任完整留给了使用者。对于计划商业化的团队，这是必须单独立项的工作量，而不是附注。

第三，"clone any app"的承诺需要打折。 README 自己承认：一个预约工具是几周量级，一个电子表格引擎不是。而 /replica-recon 只能读到公开信息——它看不到对方的后端实现、看不到未公开的边界条件、也读不出对方埋了多年的性能优化。复刻的是可见的表层功能，不是看不见的工程资产。

第四，中文语境适配是个问号。 项目面向 Claude Code 与海外应用商店生态，技能提示词全英文，listing.py 校验的是 App Store / Google Play 规则而非国内安卓渠道。对做国内市场的团队，前半段（recon/design/build）可直接用，后半段（launch/deploy）基本要重写。

第五，技术栈默认值未必合身。 默认 Next.js + Postgres + Stripe + Resend 是"零用户时便宜"的合理选择，但对已有技术栈的团队，这套默认值需要被整个替换掉——replica-architect 虽然允许"用你会的栈"，但其 schema/API 模板都是按 Postgres 写的。

行业意义：技能包正在从"单点技巧"走向"完整工作流"

把 replica-skill 放进 2026 年的技能生态里看，它标记了一个转折点：Agent Skill 正从"教模型一个技巧"进化为"封装一条完整业务流程"。

早期技能库多是单点技巧：怎么写 commit message、怎么生成 changelog、怎么做代码审查。而 replica-skill 是把一个跨角色、跨天数的项目——从竞品调研到产品上线——封装成一个有文件接口契约的工作流。每个技能读上一环的产出、写下一环的输入，这个约定本身就是 skill 之间可以组合的形式化接口。

它还示范了另一件事：把合规约束编码进工具。绝大多数 AI 编程工具只会说"请遵守许可协议"，而 sweep.py 会在部署前扫描你的代码库、发现 Cal.com 这个字符串、然后拒绝放行。约束从文档进了 CI。 这是把 Agent 从"建议者"变成"守门人"的具体路径。

而在商业侧，它精准命中了一个真实且庞大的市场：想做一个"Cal.com 的平替"或"Notion 的简化版"的人，此前卡在的不是写代码，而是不知道该写什么、怎么算写完、以及怎么不踩线。replica-skill 给出的答案是流程与验收标准，而不是更快的代码生成。

如果这套方法论真的如设计般运转，它会推动独立开发者的产品周期从"想到上线三个月"压缩到"想到上线数周"——而节省下来的时间，本质上是把 AI 从"帮你写代码"升级为"帮你管项目"。