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

Stars

209

7 天增长

暂无数据

Fork 数

33

开放 Issue

1

开源协议

MIT

最近更新

2026-07-23

为什么值得关注

它提供了一种结构化的、可重复的模式来使用 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 和编程语言匹配的相似项目。

mereyabdenbekuly-ctrl
精选
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI 与机器学习AI 智能体
833
gnipbao
精选
gnipbao GitHub avatar

story-to-handdrawn-video

A Remotion-based tool that converts Chinese story text or ordered hand-drawn images into vertical hand-drawn diary-comic animation with handwritten captions, left-to-right reveals, optional page-curl transitions, and silent H.264 output for post-production dubbing.

AI 与机器学习AI 智能体
643
xai-org
精选
xai-org GitHub avatar

grok-build

Grok Build is SpaceXAI's terminal-based AI coding agent that runs as a full-screen TUI, understands codebases, edits files, executes commands, searches the web, and manages tasks interactively or headlessly.

AI 与机器学习AI 智能体
20,399