名称： find-code-tasks
描述： 列出仓库中所有代码任务及其状态、日期和元数据。用于快速概览待办工作或查找特定任务。
type: anthropic-skill
版本： "1.0"

查找代码任务

概述

此技能用于查找并展示仓库中的所有代码任务（.code-task.md 文件），显示其 frontmatter 状态和元数据。可用于快速概览待办工作、按状态筛选任务或检查任务积压情况。

使用场景

• 开始工作前查看可用任务
• 运行 code-assist 前后检查任务状态
• 按状态（待处理、进行中、已完成）查找任务
• 获取任务积压摘要
• 导出任务数据用于报告

参数

• filter (可选): 按状态筛选任务
  • pending - 仅显示待处理任务
  • in_progress - 仅显示进行中任务
  • completed - 仅显示已完成任务
  • (无) - 显示所有任务
• format (可选，默认: "table"): 输出格式
  • table - 带状态符号的可读表格
  • json - 用于编程处理的 JSON 数组
  • summary - 仅按状态统计数量
• tasks_dir (可选，默认: ".ralph/tasks/"): 搜索任务的目录

使用示例

# 以表格格式显示所有任务
/find-code-tasks

# 仅显示待处理任务
/find-code-tasks filter:pending

# 获取用于工具的 JSON 输出
/find-code-tasks format:json

# 快速查看任务数量摘要
/find-code-tasks format:summary

# 搜索自定义目录
/find-code-tasks tasks_dir:tools/

执行步骤

1. 运行任务状态脚本

脚本位于 .claude/skills/find-code-tasks/task-status.sh。

使用适当参数执行：

# 默认：表格格式，所有任务
.claude/skills/find-code-tasks/task-status.sh

# 带筛选条件
.claude/skills/find-code-tasks/task-status.sh --pending
.claude/skills/find-code-tasks/task-status.sh --in_progress
.claude/skills/find-code-tasks/task-status.sh --completed

# 带格式参数
.claude/skills/find-code-tasks/task-status.sh --json
.claude/skills/find-code-tasks/task-status.sh --summary

# 自定义任务目录
TASKS_DIR=tools/ .claude/skills/find-code-tasks/task-status.sh

2. 呈现结果

向用户显示输出。表格格式的输出包含：

3. 建议后续操作

根据结果建议相关操作：

• 如果有待处理任务："运行 /code-assist .ralph/tasks/<任务名称>.code-task.md 开始任务"
• 如果有进行中任务："已有任务正在进行中 - 建议先完成这些任务"
• 如果所有任务都已完成："所有任务已完成！使用 /code-task-generator 创建新任务"

输出示例

表格格式（默认）

TASKS STATUS
════════════════════════════════════════════════════════════════
    TASK                                     STATUS       DATE
────────────────────────────────────────────────────────────────
○ add-task-frontmatter-tracking            待处理      2025-01-15
○ enhance-headless-tool-output             待处理      -
● fix-ctrl-c-freeze                        进行中      2025-01-14
✓ replay-backend                           已完成      2025-01-13
────────────────────────────────────────────────────────────────
总计：4 个任务

摘要格式

任务摘要
────────────
○ 待处理：     10
● 进行中：     2
✓ 已完成：     5
────────────
  总计：       17

JSON 格式

[
  {"task": "add-task-frontmatter-tracking", "status": "pending", "created": "2025-01-15", "started": null, "completed": null},
  {"task": "fix-ctrl-c-freeze", "status": "in_progress", "created": "2025-01-14", "started": "2025-01-14", "completed": null}
]

Frontmatter 结构

带 frontmatter 跟踪的任务具有以下结构：

---
status: pending | in_progress | completed | blocked
created: YYYY-MM-DD    # 任务创建日期
started: YYYY-MM-DD    # 工作开始日期（未开始则为 null）
completed: YYYY-MM-DD  # 工作完成日期（未完成则为 null）
---

没有 frontmatter 的任务将显示为 pending，日期为 null。

与其他技能的集成

• code-task-generator: 创建带 frontmatter 的新任务
• code-assist: 在开始/完成工作时更新任务状态
• ralph-code-assist: 通过 Ralph 编排器运行任务

故障排除

未找到任务

如果未显示任何任务：

• 验证任务目录是否存在：ls .ralph/tasks/
• 检查文件扩展名是否为 .code-task.md
• 尝试指定目录：/find-code-tasks tasks_dir:./

脚本未找到

如果找不到 task-status.sh 脚本：

• 确保位于仓库根目录
• 检查脚本是否存在：ls .claude/skills/find-code-tasks/task-status.sh
• 使其可执行：chmod +x .claude/skills/find-code-tasks/task-status.sh

Frontmatter 未解析

如果带 frontmatter 的任务日期显示为 -：

• 确保 frontmatter 在第 1 行以 --- 开头
• 检查 YAML 语法是否有效
• 验证字段名称是否匹配：status、created、started、completed