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

自然语言解析

支持的模式：

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

示例：

"显示包含 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 检查完成情况

最佳实践

使用场景

每日查看：
```
/wf-status
```
快速了解所有计划的进度
决策前：
```
/wf-status --active
```
查看活跃计划，决定下一步工作
详细分析：
```
/wf-status <计划名> --detail
```
查看具体计划的完整任务列表
问题排查：
```
/wf-status --blocked
```
查找阻塞的计划

与手动查询的区别

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

wf-status

المزيد من هذا المستودع

المزيد من هذا المستودع

/wf-status - 显示状态

使用方式

执行流程

0. 前置检查

1. 扫描 active 目录

2. 解析计划数据

3. 应用筛选条件

4. 生成输出

5. 进度条生成

6. 下一步建议（可选）

输出示例

默认视图（列表模式）

详细视图

筛选视图

技术细节

数据解析

自然语言解析

状态值映射

注意事项

只读约束

错误处理

与其他技能的集成

wf-plan

wf-do

wf-finish

扩展性

未来功能

最佳实践

使用场景

与手动查询的区别

相关文档

/wf-status - 显示状态

使用方式

执行流程

0. 前置检查

1. 扫描 active 目录

2. 解析计划数据

3. 应用筛选条件

4. 生成输出

5. 进度条生成

6. 下一步建议（可选）

输出示例

默认视图（列表模式）

详细视图

筛选视图

技术细节

数据解析

自然语言解析

状态值映射

注意事项

只读约束

错误处理

与其他技能的集成

wf-plan

wf-do

wf-finish

扩展性

未来功能

最佳实践

使用场景

与手动查询的区别

相关文档