Finn-loop

1. 基本信息

项目	内容
名称	Finn-loop
作者/维护者	finna（GitHub 个人开发者）
来源链接	https://github.com/finna/Finn-loop
许可证	MIT（GitHub API 确认）
GitHub Stars	230（GitHub API 获取）
Forks	39（GitHub API 获取）
最新版本	无正式 Release/Tag，滚动开发，最近一次提交 2026-07-23（GitHub API 获取）
安装方式	在目标仓库内向 Claude Code 粘贴一段安装指令，由 Agent 自动完成校验与配置

2. 功能介绍与亮点

Finn-loop 是三个协同工作的 Claude Code skills，把 Linear 与 GitHub 组合成一条“人类把关”的软件生产流水线：finn-spec 通过多轮访谈把一个模糊想法转成带验收标准（AC-N）与不做事项（NG-N）的 Linear 需求单；finn-build 认领已标记 agent-ready 的需求单，在干净工作树上实现并开出 PR；finn-review 依据同一份验收标准审查 PR 与必需的 GitHub 检查，给出结构化的三类判定（[AC-N]／[DEFECT]／[SECURITY]），全流程唯一固定规则是“只有人类能合并”。

核心亮点：

契约驱动：验收标准与不做事项以稳定编号贯穿三个技能，build 与 review 都以同一份契约为准绳，杜绝范围蔓延。
内置安全边界：build 阶段要求工作树干净、diff 出现无关改动或疑似密钥即停止；review 发现范围冲突直接标记升级给人工，而非自行决断。
可持续迭代：finn-build、finn-review 均配合 Claude Code 的 /loop 命令重复运行，一次只处理一个最小单元。

3. 适用场景

所属分类：工程效率与代码质量。适合已经在用 Linear 管理需求、代码托管在 GitHub、且希望把“想法→需求→实现→评审”这条链路交给 AI 但仍坚持人工合并把关的小型工程团队或独立开发者；尤其适合有明确验收标准思维、愿意为每个任务花时间做需求访谈换取更可控产出的场景。

4. 跨 Agent 兼容性

Claude Code：原生支持——README 明确要求 Claude Code 2.1.71 及以上版本，安装与日常运行都依赖该版本引入的 /loop 命令。
Codex：未验证——三个 SKILL.md 本身是可移植的纯文本格式，但循环执行依赖的 /loop 是 Claude Code 专属命令，材料中未提及 Codex 的等价机制，不做推测。
OpenClaw：未验证——同上，无材料佐证。
Hermes Agent：未验证——同上，无材料佐证。

5. 推荐理由

Finn-loop 把“需求访谈—自动实现—自动评审”这条常被单独实现的链路，用统一的验收标准契约串成一条闭环，并且每一步都写明了具体的安全止损点（干净工作树检查、密钥检测、范围冲突升级），而不是止步于“能跑起来”。对于已经采用 Linear + GitHub 的团队，这是一套开箱即可粘贴安装、且明确拒绝让 Agent 拥有合并权限的实用工作流。

6. 评分

维度	分数	说明
受欢迎程度	6	上线约 10 天内积累 230 GitHub Stars、39 Forks（占比约 17%），增长速度较快，落在 200–1k 区间
可用性	8	安装是一段可直接粘贴给 Claude Code 的指令，Agent 会自动完成 9 项校验并给出冒烟测试；文档含“每日节奏”“从最小闭环到完整工厂”等完整说明；但需要预先具备 Linear 工作区、已鉴权的 GitHub CLI 与指定版本的 Claude Code 三项前提，非零配置
安全性	8	有明确范围的代码执行（通过 gh CLI 操作用户已有权限的仓库），过程透明可审计，且内置多重安全止损点，见下方安全检查清单

安全检查清单： ① Shell 命令：通过 gh CLI 执行分支创建、提交、开 PR，范围限于用户本就有写权限的目标仓库，每步命令在 SKILL.md 中明写。 ② 联网外发：仅与 GitHub API、Linear Connector 交互，均为用户主动配置的官方集成，未见外发第三方地址的迹象。 ③ 凭据处理：复用用户已有的 gh auth 登录态与 Linear Connector 授权，不要求填写明文 API key。 ④ 可疑指令：逐句阅读三份 SKILL.md 未见隐藏指令或提示词注入；相反多处显式写明止损（禁止合并、diff 含无关改动或疑似密钥即停止）。 ⑤ 作者信誉：个人开发者 finna，GitHub 账号自 2012 年起活跃，名下另有多个公开项目（如 19★ 的 notionclone），无造假迹象。 ⑥ License：MIT，仓库根目录 LICENSE 文件确认。 ⑦ 维护时间：最近一次提交 2026-07-23，仓库创建约 10 天，处于早期活跃开发阶段。

综合评分：7.3（三项均值）

7. 跟同类 Skills 相比的优势

Skill	定位	与 Finn-loop 的差异
Finn-loop（本技能）	需求访谈→实现→评审的三段式闭环，Linear+GitHub 双向集成	——
twanahc/claude-linear-skill	面向 Linear 的浏览、分诊、规划与子代理协作技能	覆盖 Linear 侧的问题管理与协作，但不包含自动实现代码、开 PR、按契约评审的完整闭环
brittanyellich/loop-board	配合 Claude Code 运行“循环工程”的一套基础技能与 worker	提供通用的循环执行框架，未定义 Finn-loop 式的验收标准契约、密钥检测、范围冲突升级等具体安全止损规则
selmakcby/loop-engineering	提供带验证门禁的自运行 Agent 循环	聚焦单个“可验证循环”原语本身，不涉及 Linear 需求管理或 PR 评审阶段

8. 用户评价

该项目上线时间较短，目前在第三方平台尚无独立、可验证的具名用户评价。

9. 其他补充

README 给出从当前“最小闭环”演进为“完整软件工厂”的架构路线图（如 Slack 控制面、风险感知合并、UI 变更预览验证等），并说明这些是未来可选扩展方向，非本仓库当前已含功能。

10. 安装使用方式

前提：一个已连接 origin 远程的 GitHub 仓库、Claude Code 2.1.71 及以上版本、已启用的 Linear Connector、已完成鉴权的 GitHub CLI（gh auth status 可用）。
在目标仓库内的 Claude Code 会话中，粘贴 README 提供的安装指令（内容包括复制三份 SKILL.md 到 .claude/skills/、替换 Linear 团队标识、创建所需标签等 9 个自动化步骤）。
安装完成后运行 /reload-skills（或重启 Claude Code），确认 /skills 列表中出现 finn-spec、finn-build、finn-review。
日常使用：有想法时运行 /finn-spec 生成需求单，人工审核后打上 agent-ready 标签；运行 /loop /finn-build 持续认领实现；运行 /loop /finn-review 持续评审；只有 loop-approved 且检查全绿的 PR 才由人工合并。

11. 注意事项

仅支持 Linear 作为需求跟踪系统，不支持 Jira、GitHub Issues 等其他工具。
/loop 只在对应 Claude Code 会话保持打开时运行，首次接入建议人工观察前几轮结果与用量再放手。
同一 Linear 团队应只运行一个 builder 循环——认领机制是团队内的协作性标记，不是可跨会话互斥的原子锁。
仓库创建约 10 天，仍处早期阶段，后续维护活跃度与生态反馈有待观察。