用途:查找并展示仓库内的代码任务文件(.code-task.md),显示 frontmatter 中的状态与元数据,用于查看待办工作、按状态筛选任务或检查任务积压状态。
主要能力:支持按状态筛选(pending、in_progress、completed,不填则显示全部);支持三种输出格式,table(默认,带状态符号,○ 待处理、● 进行中、✓ 已完成、■ 阻塞)、json(JSON 数组,便于程序调用)、summary(仅按状态计数);可通过 tasks_dir 指定搜索目录,默认 .ralph/tasks/。
使用方式:命令形式为 /find-code-tasks,例如 /find-code-tasks filter:pending、/find-code-tasks format:json、/find-code-tasks format:summary、/find-code-tasks tasks_dir:tools/。底层调用与技能同目录的脚本 .claude/skills/find-code-tasks/task-status.sh,参数形式如 --pending、--in_progress、--completed、--json、--summary,自定义目录用 TASKS_DIR=tools/ 前缀。
任务 frontmatter 结构:status(pending/in_progress/completed/blocked)、created、started、completed,日期为 YYYY-MM-DD;无 frontmatter 的任务显示为 pending 且日期为空。
适用场景:开始工作前查看可用任务;运行 code-assist 前后检查状态;按状态查找任务;获取任务积压摘要;导出任务数据用于报告。与其他技能集成:code-task-generator 创建任务,code-assist 更新状态,ralph-code-assist 通过 Ralph 编排器运行任务。
限制与排查:若无任务显示,确认任务目录存在、扩展名正确或指定目录;若脚本缺失,确认处于仓库根目录、检查脚本路径并 chmod +x;若日期显示为 -,需确保 frontmatter 首行为 ---、YAML 语法有效且字段名匹配。