skill-status

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

项目状态仪表板

概览

根据工作流状态，显示当前项目状态、路线图进度、阻塞问题和智能的下一步建议。

核心原则： 读取状态 → 显示仪表板 → 智能路由。

适用场景

在用户询问以下内容时使用此技能：

• “目前状态如何？”或“展示进度”
• “我在工作流的哪个环节？”
• “接下来该做什么？”
• “当前处于哪个阶段？”
• “有没有阻塞问题？”
• “我最近在做什么？”或“总结近期工作”
• “更新项目记忆”或“更新 CLAUDE.md”

请勿用于：

• 创建新项目（使用 /octo:embrace）
• 修改状态（使用 octo-state.sh write_state）
• 详细的阶段规划（使用 flow-* 技能）

流程

阶段 1：检查项目是否已初始化

步骤 1：确认 .octo/ 目录存在

# Check if project is initialized
if [[ ! -d ".octo" ]]; then
    echo "No project initialized"
    exit 1
fi

如果 .octo/ 不存在：

## Project Status

**Status:** Not initialized

No Claude Octopus project found in this directory.

### Get Started

Run `/octo:embrace [your project description]` to initialize a new project and start the Double Diamond workflow.

**Example:**

/octo:embrace build a user authentication system

This will:
1. Create .octo/ directory structure
2. Initialize STATE.md, PROJECT.md, ROADMAP.md
3. Begin Discover phase (research and exploration)

到此为止——不要继续阶段 2。

阶段 2：读取当前状态

步骤 1：执行 octo-state.sh read_state

# Read current state from STATE.md
./scripts/octo-state.sh read_state

预期输出格式：

schema=1.0
last_updated=2026-02-02T10:30:00Z
current_phase=2
current_position=define-requirements
status=in_progress

步骤 2：解析状态变量

提取键值对：

• current_phase - 阶段编号（1-4）
• current_position - 阶段内的具体位置
• status - 当前工作流状态
• last_updated - 上次修改状态的时间戳

阶段 3：读取路线图

步骤 1：读取 ROADMAP.md

# Read roadmap for phase overview
cat .octo/ROADMAP.md

步骤 2：提取阶段信息

解析 ROADMAP.md，以识别：

• 阶段名称（Discover、Define、Develop、Deliver）
• 阶段说明
• 每个阶段的成功标准
• 阶段之间的依赖关系

阶段 4：显示仪表板

步骤 1：构建状态仪表板

## Project Status

**Phase:** Phase {current_phase} - {phase_name}
**Position:** {current_position}
**Status:** {status}
**Last Updated:** {last_updated}

### Roadmap Progress

- [x] Phase 1: Discover - complete
- [ ] Phase 2: Define - in_progress  <-- YOU ARE HERE
- [ ] Phase 3: Develop - not_started
- [ ] Phase 4: Deliver - not_started

### Current Phase Details

**Phase 2: Define (Grasp)**
- **Goal:** Clarify requirements and scope
- **Position:** {current_position}
- **Status:** {status}

### Blockers

{blockers or "None"}

### Suggested Next Action

{intelligent routing based on status}

步骤 2：确定阶段完成状态

将 current_phase 和 status 映射为完成标记：

阶段	状态	标记
1	complete	[x] Phase 1: Discover - complete
2	in_progress	[ ] Phase 2: Define - in_progress <-- YOU ARE HERE
3	not_started	[ ] Phase 3: Develop - not_started
4	not_started	[ ] Phase 4: Deliver - not_started

阶段 5：智能路由

步骤 1：将状态映射为建议

使用此路由表：

状态	建议
ready	"运行 /octo:embrace [description] 以启动工作流"
planning	"继续规划当前阶段。使用 /octo:define 细化需求。"
building	"继续实施。使用 /octo:develop 构建功能。"
in_progress	"继续当前阶段。查看 .octo/phases/phase{N}/ 了解详情。"
blocked	"查看上方的阻塞问题。使用 /octo:issues 跟踪并解决问题。"
complete	"阶段已完成。进入下一阶段，或运行 /octo:ship 完成收尾。"
complete_with_gaps	"阶段已完成，但仍有已知缺口。继续之前请查看 .octo/ISSUES.md。"
shipped	"项目已交付！查看 .octo/LESSONS.md 进行回顾总结。"
paused	"项目已暂停。使用 /octo:embrace 恢复，或查看 .octo/STATE.md 了解上下文。"

步骤 2：阶段专属路由

如果 status=in_progress，请提供阶段专属指导：

阶段 1（Discover）：

Continue research and exploration.
- Use `/octo:research [topic]` for multi-AI research
- Use `/octo:debate [question]` for decision support

阶段 2（Define）：

Continue requirements clarification.
- Use `/octo:prd` to write product requirements
- Use `/octo:define` to refine scope

阶段 3（Develop）：

Continue implementation.
- Use `/octo:develop` to build features
- Use `/octo:tdd` for test-driven development
- Use `/octo:review` for code quality checks

阶段 4（Deliver）：

Continue validation and delivery.
- Use `/octo:deliver` for final review
- Use `/octo:security` for security audit
- Use `/octo:ship` to finalize delivery

示例输出

示例 1：项目尚未初始化

## Project Status

**Status:** Not initialized

No Claude Octopus project found in this directory.

### Get Started

Run `/octo:embrace [your project description]` to initialize a new project and start the Double Diamond workflow.

**Example:**

/octo:embrace build a user authentication system

示例 2：处于 Define 阶段的活跃项目

## Project Status

**Phase:** Phase 2 - Define (Grasp)
**Position:** define-requirements
**Status:** in_progress
**Last Updated:** 2026-02-02T10:30:00Z

### Roadmap Progress

- [x] Phase 1: Discover - complete
- [ ] Phase 2: Define - in_progress  <-- YOU ARE HERE
- [ ] Phase 3: Develop - not_started
- [ ] Phase 4: Deliver - not_started

### Current Phase Details

**Phase 2: Define (Grasp)**
- **Goal:** Clarify requirements and scope
- **Position:** define-requirements
- **Status:** in_progress

### Blockers

None

### Suggested Next Action

Continue requirements clarification.
- Use `/octo:prd` to write product requirements
- Use `/octo:define` to refine scope
- Check `.octo/phases/phase2/` for detailed plans

示例 3：受阻项目

## Project Status

**Phase:** Phase 3 - Develop (Tangle)
**Position:** implement-auth
**Status:** blocked
**Last Updated:** 2026-02-02T14:15:00Z

### Roadmap Progress

- [x] Phase 1: Discover - complete
- [x] Phase 2: Define - complete
- [ ] Phase 3: Develop - blocked  <-- YOU ARE HERE
- [ ] Phase 4: Deliver - not_started

### Current Phase Details

**Phase 3: Develop (Tangle)**
- **Goal:** Implement features
- **Position:** implement-auth
- **Status:** blocked

### Blockers

- Missing OAuth provider credentials
- Database schema not finalized
- API rate limiting not configured

### Suggested Next Action

Review blockers above. Use `/octo:issues` to track and resolve issues.

**To unblock:**
1. Configure OAuth credentials in .env
2. Finalize database schema with `/octo:define`
3. Set up rate limiting configuration

阶段 6：近期活动摘要（跨会话）

当用户询问“我最近在做什么”“总结近期工作”或“更新项目记忆”时，生成跨会话活动摘要。

步骤 1：收集近期活动

# Recent git commits (last 7 days or last 20 commits)
git log --oneline --since="7 days ago" --no-merges 2>/dev/null | head -20

# Recent tags/releases
git tag --sort=-creatordate | head -5

# Recent branches worked on
git branch --sort=-committerdate | head -5

# Recent orchestration results (if any)
ls -lt ~/.claude-octopus/results/ 2>/dev/null | head -10

步骤 2：总结活动

按主题分组，生成简洁的摘要：

## Recent Activity (Last 7 Days)

### Commits
- [theme 1]: brief summary of related commits
- [theme 2]: brief summary of related commits

### Releases
- v8.10.0 - Antigravity CLI headless fix
- v8.9.0 - Contextual Codex model routing

### Active Branches
- main (current)

### Orchestration Sessions
- [count] workflows executed, [count] synthesis files generated

步骤 3：建议更新 CLAUDE.md

如果近期活动反映出 CLAUDE.md 尚未记录的模式，建议添加具体内容：

### Suggested CLAUDE.md Updates

Based on recent activity, consider adding:
- [specific suggestion based on new patterns, conventions, or decisions]
- [specific suggestion based on new tooling or workflow changes]

仅建议添加反映长期项目知识的内容（约定、架构决策、提供商配置），而不是“目前正在处理 X”之类的临时状态。

与其他技能集成

与 flow-* 技能配合

User asks "what's next?"
→ skill-status shows current phase
→ User runs /octo:develop to continue

与 skill-task-management 配合

User asks "show status"
→ skill-status displays dashboard
→ skill-task-management shows active todos

与 /octo:embrace 配合

User asks "status" but no .octo/ exists
→ skill-status suggests /octo:embrace
→ User initializes new project

最佳实践

1. 始终先检查 .octo/

正确做法：

if [[ ! -d ".octo" ]]; then
    echo "Not initialized"
    exit 1
fi

不佳做法：

# Assume .octo/ exists and fail later
cat .octo/STATE.md

2. 使用 octo-state.sh 读取状态

正确做法：

./scripts/octo-state.sh read_state

不佳做法：

# Parse STATE.md manually
grep "Current Phase" .octo/STATE.md

3. 提供可执行的后续步骤

正确做法：

Continue with `/octo:develop` to implement features.
Check `.octo/phases/phase3/` for implementation plan.

不佳做法：

You're in phase 3.

警示事项——不要这样做

操作	错误原因
直接修改 STATE.md	应改用 octo-state.sh write_state
跳过 .octo/ 是否存在的检查	会导致令人困惑的错误
显示状态但不提供下一步操作	用户不知道该做什么
将阶段名称硬编码	应从 ROADMAP.md 读取，以确保准确
忽略阻碍因素	用户需要知道是什么阻碍了进展

快速参考

用户输入	所需操作
“status”	检查 .octo/ → 读取状态 → 显示仪表板
“what's next”	读取状态 → 根据状态/阶段进行路由
“where am I”	显示当前阶段和位置
“show progress”	显示带有完成标记的路线图
“any blockers”	从 STATE.md 提取并显示阻碍因素
“what have I been working on”	Git 日志 + 结果 → 跨会话活动摘要
“update project memory”	活动摘要 → 建议添加到 CLAUDE.md 的内容

总而言之

Status check → Read state + roadmap → Display dashboard + intelligent routing
Otherwise → User doesn't know where they are or what to do next

检查初始化状态。读取状态。清晰地展示。智能地路由。