mcpField
S
solo-pipeline

solo-pipeline

github.com/fortunto2Agent 工作流1843 次安装今天更新
代码仓库

关于 solo-pipeline

solo-pipeline 是用于串联研究或开发阶段的技能，可通过 Stop hook 自动推进流程，适用于将构想整理为 PRD，或逐步完成项目实施。

主要功能

  1. 01从构想到 PRD 的研究流程
  2. 02从脚手架到构建的开发流程
  3. 03Stop hook 自动推进阶段
  4. 04通过状态文件恢复运行
  5. 05日志与可选 tmux 面板

适用场景

  1. 01将产品构想整理为研究结果和 PRD
  2. 02依次运行项目配置与实施阶段
  3. 03恢复流程并跳过已完成阶段

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/fortunto2/solo-factory --skill solo-pipeline

安装后在 Claude Code 中输入/solo-pipeline确认已加载。

详细介绍

/pipeline

启动自动化的多技能流水线。Stop 钩子会自动串联各项技能——阶段之间无需手动调用。

可用流水线

研究流水线

/pipeline research "AI therapist app"

串联：/research -> /validate 生成：research.md -> prd.md

开发流水线

/pipeline dev "project-name" "stack" /pipeline dev "project-name" "stack" --feature "user onboarding"

串联：/scaffold -> /setup -> /plan -> /build 生成：包含工作流、计划和实现的完整项目

步骤

1. 解析参数

从 $ARGUMENTS 中提取：

  • 流水线类型：第一个单词（research 或 dev）
  • 其余参数：传递给启动脚本

如果没有参数或不明确，请询问：

Which pipeline do you want to run?

1. Research Pipeline — /research → /validate (idea to PRD)
2. Dev Pipeline — /scaffold → /setup → /plan → /build (PRD to running code)
2. 向用户确认

说明将要执行的操作：

Pipeline: {type}
Stages: {stage1} → {stage2} → ...
Idea/Project: {name}

This will run multiple skills automatically. Continue?

通过 AskUserQuestion 提问。

3. 启动第一个阶段

直接运行流水线中的第一项技能：

对于研究流水线：运行 /research "idea name" 对于开发流水线：运行 /scaffold project-name stack

如果已配置 Stop 钩子，它会自动处理后续阶段。 如果没有 Stop 钩子，则按顺序手动调用各项技能。

3b. 启动脚本（可选，仅适用于 Claude Code 插件）

如果已安装 solo-factory 插件，启动脚本会提供 tmux 仪表板和日志记录：

# Only available with Claude Code plugin — skip if not installed
solo-research.sh "idea name" [--project name]
solo-dev.sh "project-name" "stack" [--feature "desc"]

在技能上下文中运行时，请传递 --no-dashboard。

5. 流水线完成

所有阶段完成后，输出：

<solo:done/>

Stop 钩子会检查此信号并清理状态文件。

状态文件

位置：.solo/pipelines/solo-pipeline-{project}.local.md（项目本地）或 ~/.solo/pipelines/solo-pipeline-{project}.local.md（全局回退位置） 日志文件：.solo/pipelines/solo-pipeline-{project}.log

格式：包含阶段列表、project_root 和 log_file 字段的 YAML frontmatter。 Stop 钩子会在每次尝试退出会话时读取此文件。

如需手动取消流水线：删除状态文件 solo-pipeline-{project}.local.md

监控

tmux 仪表板（终端使用）

从终端启动时（未使用 --no-dashboard），会自动打开 tmux 仪表板，其中包含：

  • 窗格 0：工作区
  • 窗格 1：对日志文件执行 tail -f
  • 窗格 2：实时状态显示（每 2 秒刷新）
手动监控

使用标准工具监控流水线进度：

# Watch log file
tail -f .solo/pipelines/solo-pipeline-<project>.log

# Check pipeline state

# Auto-refresh
watch -n2 -c solo-pipeline-status.sh

否则，请使用标准工具：

# Log tail
tail -f .solo/pipelines/solo-pipeline-<project>.log

# Check state file
cat .solo/pipelines/solo-pipeline-<project>.local.md
会话复用

重新运行流水线时会复用现有状态——已完成的阶段会自动跳过。

  • 无需关闭或重新创建——只需再次运行相同的命令
日志格式
[22:30:15] START    | my-app | stages: research -> validate | max: 5
[22:30:16] STAGE    | iter 1/5 | stage 1/2: research
[22:30:16] INVOKE   | /research "AI therapist app"
[22:35:42] CHECK    | research | .../research.md -> FOUND
[22:35:42] STAGE    | iter 2/5 | stage 2/2: validate
[22:35:42] INVOKE   | /validate "AI therapist app"
[22:40:10] CHECK    | validate | .../prd.md -> FOUND
[22:40:10] DONE     | All stages complete! Promise detected.
[22:40:10] FINISH   | Duration: 10m

关键规则

  1. 始终先确认，再启动流水线。
  2. 不要跳过阶段——由钩子处理阶段推进。
  3. 取消 = 删除状态文件——如果用户想停止，请告知这一点。
  4. 最大迭代次数可防止无限循环（研究默认 5 次，开发默认 15 次）。
  5. 在 Claude Code 技能上下文中运行时，使用 --no-dashboard。

评论

支持 Markdown