name: find-code-tasks description: 列出存储库中所有代码任务及其状态、日期和元数据。用于获取待处理工作的概览或查找特定任务。 type: anthropic-skill version: “1.0”

查找代码任务

概述

此技能查找并显示存储库中的所有代码任务（.code-task.md 文件），展示它们的前置元数据状态和元数据。使用它来快速概览待处理工作，按状态查找任务，或检查任务积压的状态。

何时使用

开始工作会话时查看可用任务
在运行代码辅助前后检查任务状态
按状态（待处理、进行中、已完成）查找任务
获取任务积压的摘要
导出任务数据用于报告

参数

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/<task-name>.code-task.md 以开始任务”
如果有进行中任务：“已有任务在进行中 - 考虑先完成这些”
如果所有任务都已完成：“所有任务已完成！使用 /code-task-generator 创建新任务”

输出示例

表格格式（默认）

任务状态
════════════════════════════════════════════════════════════════
    任务                                      状态        日期
────────────────────────────────────────────────────────────────
○ 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}
]

前置元数据架构

带有前置元数据跟踪的任务具有此结构：

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

没有前置元数据的任务显示为 待处理 且日期为 null。

与其他技能的集成

code-task-generator：创建带有前置元数据的新任务
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

前置元数据未解析

如果带有前置元数据的任务日期显示为 -：

确保前置元数据以第 1 行的 --- 开始
检查 YAML 语法是否有效
验证字段名称匹配：status、created、started、completed