Finn-loop 是一组三个 Claude Code 技能,通过连接 Linear 问题创建、自动 PR 构建和自动 PR 审查,构建一个由人类掌控合并权限的 AI 软件工厂。

Stars

229

7 天增长

+102

Fork 数

38

开放 Issue

0

开源协议

MIT

最近更新

2026-07-23

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它提供了一种结构化的、可重复的模式来使用 AI 代理进行软件开发,同时保持人类对合并的严格控制,并包含从启动循环演进到完整工厂(包括风险感知合并、Slack 集成和持久化工作进程)的详细路线图。

适合谁使用

  • 使用 Linear 进行问题跟踪并使用 GitHub 进行代码托管的软件团队
  • 探索 AI 辅助开发工作流的创始人或 CTO
  • 构建自动化代码生成和审查管线的开发者
  • 尝试在人类监督下进行代理驱动开发的团队

典型使用场景

  • 将粗略想法转化为带有验收标准和非目标的明确定义的 Linear 问题
  • 让 AI 代理根据规范自动实现问题并创建拉取请求
  • 自动审查打开的 PR,对照关联的问题和 CI 检查,生成审查结论
  • 持续运行构建和审查循环,处理待处理的代理就绪问题队列

项目优势

  • 人类把关:只有人类可以应用 agent-ready 标签并进行合并,确保问责制
  • 清晰的合约优先方法:Linear 中的验收标准和非目标是唯一的事实来源
  • 模块化技能:finn-spec、finn-build、finn-review 可以独立运行或循环运行
  • 文档完善的成长路径:README 提供了从启动循环发展到完整工厂的具体后续步骤

使用前须知

  • 需要 Claude Code 2.1.71+、带有连接器的 Linear 工作区和已认证的 GitHub CLI,生态锁定较强
  • 依赖会话:/loop 仅在 Claude Code 会话打开时运行,限制了无人值守操作
  • 规范质量是瓶颈;模糊的验收标准会导致自信但有问题的 PR,且系统不会为目标项目创建 CI

README 快速开始

Finn-loop

Three Claude Code skills that turn Linear + GitHub into a small, human-gated AI software factory:

idea → /finn-spec interviews you and files the issue → you label it agent-ready/finn-build claims it and opens a PR → /finn-review posts a verdict → you merge.

Three skills, one approval label, one rule: humans merge.

  • skills/finn-spec — researches the repo, interviews you until the behavior is unambiguous, then files a Linear issue with acceptance criteria (AC-N) and non-goals (NG-N).
  • skills/finn-build — claims the next safe agent-ready issue, implements only its contract, verifies it, and opens a PR. Runs repeatedly with /loop /finn-build.
  • skills/finn-review — reviews open PRs against their linked issue and required GitHub checks, then posts a three-group verdict. Runs repeatedly with /loop /finn-review.

The finn- prefix avoids collisions with Claude Code's bundled commands and with generic personal skills such as /review or /build.

Requirements

  • A Git repository hosted on GitHub, with a working origin remote
  • Claude Code 2.1.71 or newer (/loop was added in that release)
  • A Linear workspace and team
  • The Linear connector enabled in Claude Code
  • The GitHub CLI (gh) authenticated with write access to the target repo
  • At least one required GitHub status check if you want fully automated loop-approved verdicts; without required CI, Finn-loop escalates the PR for human review

Recommended: connect Linear's GitHub integration so linked PRs can update issue status when they open and merge.

Install

Paste this into Claude Code inside the repo where you want the factory:

Set up Finn-loop from https://github.com/finna/Finn-loop.

1. Copy these files from that repo into this repo, preserving their contents:
   skills/finn-spec/SKILL.md   → .claude/skills/finn-spec/SKILL.md
   skills/finn-build/SKILL.md  → .claude/skills/finn-build/SKILL.md
   skills/finn-review/SKILL.md → .claude/skills/finn-review/SKILL.md

2. Ask for my Linear team key (for example ENG), then replace every TEAM
   placeholder in the copied skills with that exact key.

3. Check `claude --version` is 2.1.71 or newer.

项目描述

The Finn-loop: a 3-skill AI software factory for Claude Code — spec, build, review. Humans merge.

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

S40911120
精选
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI 与机器学习大语言模型
67
bjan
精选
bjan GitHub avatar

claudemux

Claudemux is a lightweight, dependency-minimal message bus that lets multiple Claude Code sessions communicate in real-time over tmux, enabling one session to ask another a question and receive the answer without manual intervention.

AI 与机器学习AI 智能体
9
hoainho
hoainho GitHub avatar

img2threejs

img2threejs reconstructs a 3D object from a single reference image as a procedural Three.js model using code-only, token-efficient, staged pipeline with quality gates, producing animation-ready Three.js groups.

Python
7,414