convez.ai
SkillProdutividadeAvançado
Leo0426

ForgeFlow

Leo0426/forge-flow

Skills estruturados para IA fazer engenharia real com restrições e metodologia

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework de engenharia de software colaborativa com IA que estrutura o trabalho do Claude em skills discretos e restritos, cobrindo todo o ciclo de vida de desenvolvimento: desde descoberta de produto até operações. Cada skill encapsula um protocolo de trabalho de engenheiro experiente, evitando que a IA trabalhe sem direção clara.

Instalação

$npx convez-ai Leo0426/forge-flow

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Implementar features com TDD e ciclos red-green-refactor estruturados
  • Decompor PRDs e requisitos em tarefas de engenharia independentes e verificáveis
  • Revisar código, arquitetura e decisões de design com checklist metodológico
  • Gerenciar ciclos completos de release, diagnóstico e operações com runbooks
  • Estruturar descoberta de produto e transformar feedback em roadmaps

Veredito

Ferramenta madura para times que querem protocolar o trabalho com IA, reduzindo improviso. Melhor valor para desenvolvedores experientes que já têm metodologia clara e querem formalizá-la em skills reutilizáveis.

README

A tradução para o português deste README ainda está na fila.

ForgeFlow

面向个人开发者的 AI 协作软件工程能力框架。把优秀工程师的工作方法协议化,以 Claude Code / Codex 插件形式分发,让 Agent 在固定流程约束下工作,而不是自由发挥。

设计思路

AI 的问题不是能力不足,而是缺乏约束——不知道何时停下来问、何时写测试、何时从全局看问题。ForgeFlow 的每个 Skill 是一个约束单元,把工程师的判断时机固化成可触发的流程。

详见 meta/PHILOSOPHY.md 和 meta/METHODOLOGY.md。

Skills

decision

Skill说明
decision/decision-forge推进复杂设计与工程决策收敛,把模糊想法变成可执行、可追溯的工程决策

engineering

Skill说明
engineering/coding-with-tdd红绿重构循环实现功能或修复 bug,通过公共接口验证行为
engineering/architecture识别并改进代码库架构复杂度,基于 Deep Module 和分层一致性提出改进候选
engineering/code-review对当前 diff 做正确性、简化/复用和方法论对齐三类审查
engineering/zoom-out上升一层抽象,给出当前代码区域的系统地图:相关模块、调用者、依赖方向
engineering/git-commit从当前变更中提炼最小一致性提交,生成高质量 git commit

governance

Skill说明
governance/issue-breakdown用垂直切片把 PRD 或计划拆成可独立验证的工程任务
governance/diagnose-lite轻量诊断:最小复现、假设、验证、修复、再验证
governance/repo-health检查仓库健康度:ownership、依赖、安全、架构漂移、测试质量

operations

Skill说明
operations/release管理发布生命周期:发布前验收、版本说明、rollback plan、发布后检查
operations/operate管理运行维护生命周期:observability、runbook、incident intake、维护节奏

product

Skill说明
product/discovery在进入 PRD 前验证问题、用户、替代方案和 MVP 成功指标
product/to-prd将想法或对话上下文整理成轻量 PRD
product/feedback-to-roadmap将发布后反馈、数据和复盘结论整理成下一轮 roadmap

misc

Skill说明
misc/setup-forgeflow在新仓库中初始化 ForgeFlow agent runtime 上下文(首次使用前运行)
misc/personal-skill-builder创建、优化和评审结构化 agent skills
misc/terse-communication中英双语极简沟通模式,压缩冗余,保留技术准确性

工程生命周期

阶段推荐 Skill
问题验证product/discovery
需求整理product/to-prd
决策收敛decision/decision-forge
任务拆解governance/issue-breakdown
编码实现engineering/coding-with-tdd
架构改进engineering/architecture
问题诊断governance/diagnose-lite
发布operations/release
运维operations/operate
反馈迭代product/feedback-to-roadmap
仓库治理governance/repo-health

用法

作为 Claude Code 插件

# 构建插件包
python3 tools/build_plugins.py
# 加载到 Claude Code
claude --plugin-dir ./build/plugins/claude-code/forgeflow

加载后在对话中直接使用斜杠命令:

/forgeflow:setup-forgeflow      → 初始化仓库运行时上下文(首次使用先运行这个)
/forgeflow:decision-forge       → 决策收敛
/forgeflow:coding-with-tdd      → TDD 红绿重构
/forgeflow:architecture         → 架构改进
/forgeflow:code-review          → diff 审查
/forgeflow:zoom-out             → 系统地图
/forgeflow:git-commit           → 语义化 commit
/forgeflow:issue-breakdown      → 任务拆解
/forgeflow:diagnose-lite        → 问题诊断
/forgeflow:repo-health          → 仓库健康检查
/forgeflow:release              → 发布管理
/forgeflow:operate              → 运维管理
/forgeflow:discovery            → 问题验证
/forgeflow:to-prd               → 轻量 PRD
/forgeflow:feedback-to-roadmap  → 反馈转 roadmap
/forgeflow:terse-communication  → 极简沟通模式
/forgeflow:personal-skill-builder → 创建新 skill

作为 Codex 插件

codex plugin marketplace add ./build/plugins/codex

项目结构

skills/         可复用 skill,按 bucket 分类
  decision/
  engineering/
  governance/
  operations/
  product/
  misc/
meta/           设计文档
  PHILOSOPHY.md   核心思路
  METHODOLOGY.md  架构设计方法论
CONTEXT.md      领域术语表
tools/          插件打包脚本

鸣谢

mattpocock/skills — 把工程师工作方式显式化为可触发 Skill 的最佳范例。

许可证

MIT

Ver o original no GitHub

Bom para

Relacionados