概述

pinable-auto 是 PinableAgents 的自动功能开发模块，它不替代现有的 do、omo、bmad、sparv、requirements 工作流，而是补上三类能力：

能力	说明
外层自动编排	协调多个 Agent 完成端到端功能交付
流程树/失败分支设计	在实现前明确工作流、边界、失败处理
专项验证与交付检查	API 测试、无障碍审计、DevOps 验证

命令

/pinable-auto <FEATURE_DESCRIPTION> [OPTIONS]
/pinable-auto-run <FEATURE_DESCRIPTION> [OPTIONS]

选项

选项	说明
--no-harness	单次执行，不使用 harness 持久化状态
--skip-api-tests	跳过 API/接口专项验证
--skip-a11y	跳过前端无障碍专项验证
--skip-devops-check	跳过 CI/发布检查

命令模式

命令	模式	默认行为
/pinable-auto	标准自动化	按任务复杂度选择单次执行或 harness
/pinable-auto-run	强自动化	worktree + harness + 自动假设 + 专项验证 + 自动提交

流水线概览

用户请求 → pinable-auto-orchestrator → workflow-architect → do agents
                                                    ↓
                              ┌──────────────────────┼──────────────────────┐
                              │                      │                      │
                              ▼                      ▼                      ▼
                        api-tester          accessibility-           devops-automator
                                              auditor
                              │                      │                      │
                              └──────────────────────┼──────────────────────┘
                                                     │
                                                     ▼
                                            pinable-auto-orchestrator
                                                     │
                                                     ▼
                                                完成交付

Phase 详解

Phase	Primary Agent	Substage	产出物
0	pinable-auto-orchestrator	initialized	auto-state.json
1	workflow-architect	workflow_mapped	workflow-map.md
2	do agents	implemented	git commit
3	api-tester / accessibility-auditor	specialist_validating	*-validation.md
4	devops-automator	delivery_validating	delivery-validation.md
5	pinable-auto-orchestrator	finalized/completed	final-summary.md

Substage 状态流转

initialized → analyzed → clarified → workflow_mapped → execution_planned
    → implementing → implemented → specialist_validating
    → delivery_validating → finalized → completed

Agent 职责

Agent	角色
pinable-auto-orchestrator	自动功能开发总控
workflow-architect	流程树、状态机、失败分支设计
api-tester	API/绑定/接口专项验证
accessibility-auditor	React/Wails 前端无障碍审计
devops-automator	CI/CD、构建、发布检查

Surface 选择

根据代码变更涉及的范围，自动选择需要运行的专项验证：

Surface	触发条件	专项 Agent
backend	Backend/API 变更	api-tester
bindings	绑定层变更	api-tester
frontend	Frontend/UI 变更	accessibility-auditor
devops	CI/Release 变更	devops-automator

设计原则

• 优先复用现有 do 作为实现内核
• 长任务默认接 harness
• 不引入 Laravel、Jira、固定 HTTP 端口等外部预设
• 针对 Go + Wails + React 仓库结构做适配

验证门禁

完成前必须通过以下检查：

• workflow-map.md 存在
• implementation commit 存在
• 专项验证已运行或明确跳过
• 相关测试/构建已运行
• 剩余风险已明确

与其他工作流的区别

维度	do	pinable-auto
流程复杂度	低（3 阶段）	中-高（6 阶段）
编排方式	单 agent	多 agent 协作
流程设计	无	workflow-architect
专项验证	基础审查	API + A11y + DevOps
适用场景	功能边界清晰	需要多面验证的全栈功能