wf-status

name	wf-status
description	显示 WikiFlow 当前状态和任务进度。列出活跃开发计划，显示进度条和任务统计，支持筛选和自然语言查询。
metadata	{"version":"1.0.0","execution_location":"documentation_repository","type":"extension","read_only":true}

/wf-status - 显示状态

⚠️ 重要约束：本技能必须在文档仓库中执行

显示 WikiFlow 当前状态和任务进度，列出所有活跃开发计划。

架构依据：current/architecture.md - 文档与代码分离

使用方式

# 显示所有活跃开发计划
/wf-status

# 显示详细信息
/wf-status --detail

# 按状态筛选
/wf-status --active
/wf-status --draft

# 关键词筛选
/wf-status website
/wf-status "git"

# 组合筛选
/wf-status --active "website"

# 自然语言筛选
/wf-status "显示包含 website 的计划"
/wf-status "进度超过 50% 的计划"

执行流程

0. 前置检查

读取 .wikiflow/config.json，获取路径配置。

**检查当前仓库类型**：

检查当前目录特征：
  IF 存在 .wikiflow/config.json AND docs/wiki/ 目录:
    → 当前是文档仓库
    → ✅ 继续执行

  ELSE:
    → 当前不是文档仓库
    → ❌ 错误：wf-status 必须在文档仓库执行
    → 报错并提示：
      "❌ 操作被拒绝：wf-status 必须在文档仓库执行

       当前仓库：代码仓库（或无法识别）
       尝试操作：查看状态
       允许操作：代码修改、测试、构建

       请切换到文档仓库后重试：
       1. 查找文档仓库目录（如 ../wikiflowDev）
       2. 切换到文档仓库目录
       3. 再次执行 /wf-status"
    → 退出执行

检查 active 目录是否存在：
  → 检查 {paths.changes}/active/ 是否存在
  → 如果不存在，提示用户："当前没有活跃的开发计划"

1. 扫描 active 目录

扫描目录：{paths.changes}/active/

FOR 每个子目录:
  → 验证是否包含 spec.md 和 tasks.md
  → 如果缺少文件，跳过该目录并警告

收集所有有效的开发计划：
  → 目录名（如 2026-04-24-wf-status-command）
  → spec.md 路径
  → tasks.md 路径
  → decisions.md 路径（可选）

2. 解析计划数据

FOR 每个开发计划:
  1. 读取 spec.md：
     → 提取标题（第一行，去掉 # 符号）
     → 提取元数据：创建时间、状态、相关 Wiki
     → 提取目标（## 目标部分的第一段）
     → 提取描述（从目标或当前问题中提取）

  2. 读取 tasks.md：
     → 统计总任务数：匹配 `- [` （所有任务）
     → 统计已完成：匹配 `- [x]`
     → 统计待执行：匹配 `- [ ]`
     → 计算进度百分比：(已完成 / 总数) * 100

  3. 获取最后更新时间：
     → 优先读取 decisions.md 的修改时间
     → 如果 decisions.md 不存在，读取 tasks.md 的修改时间

  4. 处理目录名：
     → 从目录名中提取短名称（去掉日期前缀）
     → 如：2026-04-24-wf-status-command → wf-status-command

3. 应用筛选条件

IF 用户指定了筛选参数:
  → 按状态筛选：--active、--draft、--paused、--blocked
  → 关键词筛选：匹配计划名或描述中的关键词
  → 组合筛选：AND 逻辑（如 --active AND 包含 "website"）

IF 用户使用自然语言:
  → 解析自然语言模式：
    • "显示包含 X 的计划" → 关键词筛选
    • "进度超过 X% 的计划" → 百分比筛选
    • "昨天创建的计划" → 时间筛选
    • "状态为 active 的计划" → 状态筛选

只保留符合条件的计划

4. 生成输出

生成标准化的状态输出：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 WikiFlow 状态概览

活跃开发计划：{N} 个

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. {计划短名称}
   状态：{active|draft|paused|blocked}
   进度：{进度条} {百分比}% ({已完成}/{总数} 任务完成)
   创建时间：{YYYY-MM-DD} | 最后更新：{YYYY-MM-DD HH:MM}
   描述：{简短描述（最多 50 字）}

2. {计划短名称}
   ...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

如果用户指定 --detail：
  → 显示完整的任务列表
  → 按模块分组
  → 标注任务状态（✅ 已完成、⏳ 待执行）

如果用户没有指定筛选：
  → 添加"下一步建议"部分
  → AI 分析每个计划的状态
  → 提供可操作的建议

5. 进度条生成

定义进度条字符：
  → 已完成：█
  → 未完成：░
  → 总格数：10

生成逻辑：
  percentage = (已完成 / 总数) * 100
  filled = round(percentage / 10)
  empty = 10 - filled
  进度条 = █ repeated {filled} + ░ repeated {empty}

示例：
  0%:   ░░░░░░░░░
  23%:  ██░░░░░░░░
  50%:  ██████░░░░
  75%:  ████████░░
  100%: ██████████

边界情况：
  → 总数为 0：░░░░░░░░░ (0%)
  → 已完成 > 总数：██████████ (100%)

6. 下一步建议（可选）

IF 用户没有指定筛选且计划数量 > 0:
  → AI 分析每个计划的状态
  → 生成可操作的建议

分析维度：
  1. 长时间未更新的计划（> 7 天）
  2. 进度过半但长期停滞的计划
  3. 刚创建的建议优先完成的计划
  4. 有大量待执行任务的计划

建议格式：
  "下一步建议：
    • {计划名} 有 {N} 个待执行任务，建议优先完成 {模块名} 部分
    • {计划名} 进度过半，建议检查是否有阻塞任务
    • {计划名} 刚创建，建议先完成技能定义"

输出示例

默认视图（列表模式）

/wf-status

📊 WikiFlow 状态概览

活跃开发计划：3 个

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. wikiflow-website
   状态：active | 进度：██░░░░░░░░ 23% (24/65 任务完成)
   创建时间：2026-04-23 | 最后更新：2026-04-24 09:48
   描述：为 WikiFlow 项目开发参考 Ollama 风格的官方网站

2. git-workflow
   状态：active | 进度：█████░░░░ 50% (5/10 任务完成)
   创建时间：2026-04-24 | 最后更新：2026-04-24 09:50
   描述：改进 Git 工作流，支持分支管理和代码审查

3. wf-status-command
   状态：draft | 进度：░░░░░░░░░ 0% (0/15 任务完成)
   创建时间：2026-04-24 | 最后更新：2026-04-24 10:00
   描述：开发 /wf-status 扩展命令

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

下一步建议：
  • wikiflow-website 有 27 个待执行任务，建议优先完成静态资源和质量保证部分
  • git-workflow 进度过半，建议检查是否有阻塞任务
  • wf-status-command 刚创建，建议先完成技能定义

使用 /wf-status <计划名> 查看详情
使用 /wf-status --filter "website" 筛选计划

详细视图

/wf-status wikiflow-website --detail

📊 wikiflow-website 详细状态

状态：active
进度：██░░░░░░░░ 23% (24/65 任务完成)
创建时间：2026-04-23
最后更新：2026-04-24 09:48

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

## 项目初始化（3/3 已完成）
✅ 创建 `website/` 目录结构
✅ 初始化 VitePress 项目
✅ 配置 TypeScript 和 package.json

## VitePress 配置（5/5 已完成）
✅ 配置 `.vitepress/config.ts`
✅ 设置中文语言支持
✅ 配置 SEO
✅ 启用搜索功能
✅ 配置构建输出目录

## 主题开发（7/7 已完成）
✅ 创建自定义样式文件
✅ 定义配色方案
✅ 自定义首页布局
✅ 设计 Skills 卡片组件
✅ 实现响应式设计
✅ 自定义代码块样式
✅ 添加 hover 效果

## 首页内容（5/5 已完成）
✅ 编写 `index.md`
✅ 添加 WikiFlow 介绍
✅ 编写快速开始指南
✅ 创建核心特性展示区域
✅ 设计 CTA 按钮

## Skills 文档（10/10 已完成）
✅ 创建 `skills/index.md`
✅ 设计 Skills 分类和卡片布局
✅ 从 skill.md 提取内容
✅ 编写各技能文档

## 静态资源（0/3 已完成）
⏳ 设计 WikiFlow Logo（SVG/PNG）
⏳ 创建特性图标（3-4 个）
⏳ 准备 favicon 和 PWA 图标

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

待执行任务：27 个
下一步建议：优先完成静态资源部分

筛选视图

/wf-status --active "website"

📊 WikiFlow 状态概览（筛选：active + 包含 "website"）

找到 1 个符合条件的计划：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. wikiflow-website
   状态：active | 进度：██░░░░░░░░ 23% (24/65 任务完成)
   创建时间：2026-04-23 | 最后更新：2026-04-24 09:48
   描述：为 WikiFlow 项目开发参考 Ollama 风格的官方网站

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

技术细节

数据解析

spec.md 解析：

# 标题 → 提取标题

## 元数据
- 创建时间：2026-04-24 → 提取创建时间
- 状态：active → 提取状态
- 相关 Wiki：current/architecture.md → 提取相关 Wiki

## 目标
{目标内容} → 提取简短描述（前 50 字）

tasks.md 解析：

匹配规则：
  `- [` 开头的行 → 任务
  `- [x]` → 已完成
  `- [ ]` → 待执行
  `- [-]` → 取消（不计入总数）
  `- [?]` → 阻塞（计入待执行）

统计：
  总数 = 已完成 + 待执行
  进度 = (已完成 / 总数) * 100

自然语言解析

支持的模式：

1. 包含关键词："包含"、"含有"、"关于"
2. 进度筛选："超过"、"大于"、"低于"、"少于"
3. 时间筛选："今天"、"昨天"、"本周"
4. 状态筛选："状态为"、"状态是"

示例：

• "显示包含 website 的计划" → 关键词 = "website"
• "进度超过 50% 的计划" → 进度 > 50%
• "昨天创建的计划" → 创建时间 = 昨天
• "状态为 active 的计划" → 状态 = "active"

状态值映射

spec.md 中的状态 → 显示标签

active → "active"（活跃开发中）
draft → "draft"（草稿，刚创建）
paused → "paused"（暂停）
blocked → "blocked"（阻塞）
completed → "completed"（已完成，但未归档）

注意事项

只读约束

允许的操作：

• ✅ 读取 .wikiflow/config.json
• ✅ 读取 docs/changes/active/ 目录
• ✅ 解析 spec.md、tasks.md、decisions.md
• ✅ 显示格式化的输出

禁止的操作：

• ❌ 修改任何文件
• ❌ 创建或删除文件
• ❌ 执行 Git 操作
• ❌ 修改代码仓库

错误处理

文件缺失：

⚠️ 警告：计划 2026-04-24-xxx 缺少 spec.md，跳过

目录为空：

📭 当前没有活跃的开发计划

提示：
  → 使用 /wf-plan 创建新计划
  → 或检查 {paths.changes}/active/ 目录

解析失败：

❌ 错误：无法解析 tasks.md

文件路径：docs/changes/active/2026-04-24-xxx/tasks.md

可能原因：
  • 文件格式不正确
  • 缺少任务标记（- [ ] 或 - [x]）

建议：
  → 检查文件格式
  → 或使用 /wf-fix 修复

与其他技能的集成

wf-plan

创建计划后：

✅ 计划已生成：docs/changes/active/2026-04-24-wf-status-command

当前状态：
  → 活跃开发计划：3 个
  → 建议使用 /wf-status 查看详情

wf-do

执行过程中：

📊 开发进度

计划：wf-status-command
总任务：15
已完成：5 / 15（33.3%）

✅ 技能定义与配置
⬜ 数据解析与统计
⬜ 输出格式设计
...

→ /wf-status 查看所有计划状态

wf-finish

完成前提示：

准备将 wf-status-command 编译到 Wiki

当前状态：
  → 进度：██████████ 100% (15/15 任务完成)
  → 最后更新：2026-04-24 12:00

建议：
  → 使用 /wf-status 确认所有任务已完成
  → 确认后执行 /wf-finish

扩展性

未来功能

健康检查模式：

/wf-status --health

检查项：
  [ ] 是否有长期未更新的计划（> 7 天）
  [ ] 是否有阻塞任务
  [ ] 是否有过多并行工作流（> 5 个）
  [ ] 是否有未同步的决策日志
  [ ] Wiki 文档是否过时

趋势分析：

/wf-status --trend

显示：
  • 每个计划的进度历史
  • 预计完成时间
  • 速度趋势（任务/天）

集成到其他技能：

• wf-plan 自动显示状态
• wf-do 实时更新进度
• wf-finish 检查完成情况

最佳实践

使用场景

1. 每日查看：

   /wf-status
   

   快速了解所有计划的进度

2. 决策前：

   /wf-status --active
   

   查看活跃计划，决定下一步工作

3. 详细分析：

   /wf-status <计划名> --detail
   

   查看具体计划的完整任务列表

4. 问题排查：

   /wf-status --blocked
   

   查找阻塞的计划

与手动查询的区别

维度	手动查询	/wf-status
输出格式	不一致	标准化
信息完整度	依赖 AI 提问	完整展示
可操作性	需要多次查询	一次获取全部
进度可视化	无	ASCII 进度条
筛选功能	需要重新查询	参数化筛选

相关文档

• current/architecture.md - 文档与代码分离架构
• wf-plan skill - 制定开发计划
• wf-do skill - 执行开发任务
• wf-finish skill - 编译到 Wiki