mano-afk

mano-afk 全自动流水线：用自然语言描述即可自动构建、部署并测试应用。全程用户 AFK。 该技能会从每个项目学习——构建规则与用户偏好跨会话持久化，输出质量与用户口味随时间提升。 Claude Code 用户：请使用 claude/SKILL.md 中的 Claude Code 专用说明。

架构 三角色协同交付应用：

• 主代理（你）：编排、测试执行、修复协调、用户沟通
• 构建子代理：需求 → 架构 → 代码 → 部署 → 修复（仅当给出具体错误）
• 对抗子代理：独立设计测试用例（不执行测试）

主代理将代码生成委托给子代理（最耗时段），自身空闲；所有测试由主代理直接运行，结果完全可见。

编排 AFK 规则 仅 Step 0 可与用户交互；Step 1 起完全自主决策，永不询问用户。 模糊决策（8bit vs float、React vs Vue、端口选择）采用最合理默认，并在 PRD.md 中记录。 仅当完全不可行（缺硬件、无权限、10 轮修复耗尽）才停止。

Step 0：用户设置（交互） 唯一可提问阶段。

• 需求梳理：请求过模糊（如“做个应用”）或存在歧义时，用 1–2 个聚焦问题请用户澄清；非关键缺口由构建子代理自动填补。
• LLM 功能检查：若需 LLM/AI 功能，询问用户 API key 的环境变量名（如 OPENAI_API_KEY）。
• E2E 测试模式：

– local：需配置 default-model-path – cloud：需 ANTHROPIC_API_KEY – 未设置：首次 setup 平台检查： – macOS：问 Local / Cloud / Skip – 其他：仅 Cloud 或 Skip 按输出指引完成配置；用户拒绝则 Skip，记入 report.md。 Step 0 结束语：“Hold the beer. AFK from now on.”

Step 1：准备（自主）

• 从请求生成 kebab-case 项目名（如“make me a todo app” → todo-app）
• 项目目录：{projects-dir}/{project-name}/（默认 ~/Projects/）
• 读取 references/report-template.md，记录 references/ 绝对路径供子代理使用

Step 2：构建（子代理）

• sessions_spawn 启动子代理，runtime="subagent"
• 提示包含：build-pipeline.md 路径、references/ 路径、用户原请求、项目目录路径
• 立即向用户回复正在构建的内容及目录
• 子代理内部 4 阶段：PRD.md → README.md（含测试用例）→ 编码 → 部署
• 等待 progress.md 状态为 ready_for_testing；超时至少 30 分钟或无超时

Step 3：验证部署

• 确认 deploy/start.sh 存在并运行，curl/端口检查通过
• 失败则读 backend.log/frontend.log，进入 Step 5 修复循环

Step 4：测试 执行全部测试用例