octopus-quick

宿主：Codex CLI — 此技能专为 Claude Code 设计，并已适配 Codex。 交叉引用命令在 Codex 中使用已安装的技能名称，而不是 /octo:* 斜杠命令。 使用当前启用的 Codex shell 和子 Agent 工具。在当前会话尚未提供相关能力前，不要声称某个提供商、模型或宿主子 Agent 可用。 宿主工具的对应项请参阅 skills/blocks/codex-host-adapter.md。

快速模式 - 轻量级任务执行 ⚡

为无需完整 Double Diamond 工作流开销的小型任务提供快速执行方式。

何时使用快速模式

✅ 适用于快速模式的情况：

错误修复：

• 已知解决方案的单文件错误修复
• 修正拼写错误
• 修复逻辑错误
• 修正导入/导出

配置更改：

• 更新环境变量
• 修改配置文件
• 调整设置
• 更新依赖项

小型重构：

• 重命名变量/函数
• 提取辅助函数
• 简化单个文件中的逻辑
• 清理代码

文档：

• 修正 README 中的拼写错误
• 更新注释
• 添加/更新文档字符串
• 澄清文档内容

依赖项管理：

• 更新软件包版本
• 添加新依赖项
• 移除未使用的依赖项

❌ 不适用于快速模式的情况：

复杂工作：

• 新功能
• 架构更改
• 多文件重构
• 安全敏感型更改
• 需要研究的性能优化
• 数据库架构更改
• API 契约更改

复杂工作请使用完整工作流，以确保质量。

执行流程

快速模式采用精简流程：

User Request → Direct Implementation → Atomic Commit → Summary

快速模式会跳过：

• ❌ 多 AI 研究（probe/discover）
• ❌ 需求规划（grasp/define）
• ❌ 多 AI 验证（ink/deliver）
• ❌ 计划检查器验证

快速模式会保留：

• ✅ 状态跟踪（记录在 state.json 中）
• ✅ 原子提交（附带说明的 git commit）
• ✅ 生成摘要（存储在 .claude-octopus/quick/ 中）
• ✅ 更改文档记录

用法

通过命令

/octo:quick "add dark mode toggle to settings"

通过技能调用

Use skill: octopus-quick
Task: "fix typo in README.md line 42"

示例

/octo:quick "update Next.js to v15"
/octo:quick "fix the broken import in auth.ts"
/octo:quick "add error handling to login function"
/octo:quick "remove console.log statements"

实现

步骤 1：了解任务

快速评估：

• 需要更改哪些文件？
• 具体要做什么更改？
• 是否存在依赖项或副作用？

步骤 2：进行更改

使用适当的工具直接实施：

• Edit - 修改现有文件
• Write - 创建新文件（快速模式中较少见）
• Bash - 执行文件操作、更新依赖项

步骤 3：创建原子提交

始终创建描述清晰的提交：

# Stage changes
git add [changed-files]

# Create commit with clear message
git commit -m "quick: [brief description]

[Detailed explanation if needed]

Co-Authored-By: Claude Sonnet 4.6 <[email protected]>"

提交信息格式：

• 使用 quick: 前缀标明快速模式
• 使用现在时简要描述
• 可选的详细说明
• 共同创作标记

步骤 4：记录状态

# Update state with quick task execution
"${HOME}/.claude-octopus/plugin/scripts/state-manager.sh" write_decision \
  "quick" \
  "$(git log -1 --pretty=%s)" \
  "Ad-hoc task executed in quick mode"

# Update metrics
"${HOME}/.claude-octopus/plugin/scripts/state-manager.sh" update_metrics \
  "execution_time" \
  "1"  # Estimated in minutes

步骤 5：生成摘要

# Create quick task summary
mkdir -p .claude-octopus/quick

summary_file=".claude-octopus/quick/$(date +%Y%m%d-%H%M%S)-summary.md"

cat > "$summary_file" <<EOF
# Quick Task: $(git log -1 --pretty=%s)

## Task Description
$TASK_DESCRIPTION

## Changes Made
$(git diff HEAD~1..HEAD --stat)

## Files Modified
$(git diff --name-only HEAD~1..HEAD)

## Commit
$(git rev-parse HEAD)

## Timestamp
$(date -u +%Y-%m-%dT%H:%M:%SZ)

*Executed in Quick Mode - minimal overhead execution*
EOF

echo "📝 Summary saved to: $summary_file"

完整示例

用户请求：

/octo:quick "fix typo in README - change 'recieve' to 'receive'"

执行：

1. 读取文件

   Read README.md to locate the typo
   

2. 进行更改

   Edit README.md: replace "recieve" with "receive"
   

3. 原子提交

   git add README.md
   git commit -m "quick: fix typo in README (recieve → receive)
   
   Co-Authored-By: Claude Sonnet 4.6 <[email protected]>"
   

4. 记录状态

   state-manager.sh write_decision "quick" \
     "Fixed typo in README" \
     "Ad-hoc documentation fix"
   

5. 生成摘要

   Created: .claude-octopus/quick/20260129-143045-summary.md
   

6. 向用户报告

   ✅ Fixed typo in README.md
   📝 Commit: abc123f
   📋 Summary: .claude-octopus/quick/20260129-143045-summary.md
   

快速模式的优点

速度 ⚡

• 无需承担多 AI 协调开销
• 直接实施
• 处理简单任务更快

节省成本 💰

• 不调用外部提供商 API
• 仅使用 Claude（已包含在 Claude Code 中）
• 适用于高效处理临时任务

仍可跟踪 📊

• 记录提交
• 更新状态
• 生成摘要
• 保留完整审计跟踪

范围恰当 🎯

• 小型任务使用合适的工具
• 不会对简单更改过度设计
• 将完整工作流留给复杂工作

快速模式不够用时

如果在执行过程中发现任务比预期复杂：

停止并升级到完整工作流：

This task is more complex than anticipated. I recommend using the full
workflow instead:

- For research: /octo:discover "research authentication patterns"
- For planning: /octo:define "define auth requirements"
- For building: /octo:develop "implement auth system"
- For validation: /octo:deliver "validate auth implementation"

Would you like me to switch to a full workflow?

升级信号：

• 需要更改多个文件
• 需要做出架构决策
• 需要研究或比较
• 涉及安全影响
• 涉及性能影响
• 存在不兼容更改

目录结构

Quick mode 会在专用目录中创建摘要：

.claude-octopus/
└── quick/
    ├── 20260129-143045-summary.md
    ├── 20260129-150122-summary.md
    └── 20260129-161530-summary.md

每份摘要都包含：

• 任务描述
• 所做更改
• 修改的文件
• 提交哈希
• 时间戳

对比：Quick Mode 与 Full Workflow

方面	Quick Mode ⚡	Full Workflow 🐙
耗时	1-3 分钟	5-15 分钟
成本	仅使用 Claude	Claude 加可用的外部提供方
提供方	1 个（Claude）	可用的提供方集群
研究	无	全面
规划	无	详细
验证	基础	多 AI 审查
适用于	简单修复	复杂功能
使用时机	解决方案已知	解决方案未知

最佳实践

应该：

• ✅ 对简单直接的任务使用 Quick mode
• ✅ 编写描述性提交消息
• ✅ 生成摘要以留存审计记录
• ✅ 即使在 Quick mode 下也更新状态
• ✅ 如果复杂度增加，则升级到 Full Workflow

不应该：

• ❌ 将 Quick mode 用于新功能
• ❌ 跳过提交（始终进行原子化提交）
• ❌ 跳过状态更新（保持一致性）
• ❌ 将 Quick mode 用于安全敏感的更改
• ❌ 在适合使用 Full Workflow 时强行使用 Quick mode

故障排除

“Quick mode 耗时过长”

→ 任务可能过于复杂。升级到 Full Workflow。

“更改导致测试失败”

→ Quick mode 假设更改简单且安全。对于有风险的更改，请使用 Full Workflow。

“需要研究最佳方案”

→ Quick mode 仅适用于解决方案已知的情况。使用 /octo:discover 进行研究。

“需要修改多个文件”

→ 可考虑使用 /octo:develop 协调多文件更改。

总结

对于解决方案已知的简单直接任务，Quick mode 是合适的工具。它能快速执行，同时保留必要的跟踪和文档记录。

其他情况都应使用完整的 Double Diamond 工作流，通过多 AI 编排确保质量。

请记住：速度固然重要，但正确更重要。如有疑问，请使用完整工作流。