SuperAPI AI 工具集

pod-resume

办公与效率

查看项目

更新于 10-24 01:08

技能介绍

用途

pod-resume 面向离开项目一段时间后重返的开发者,目标是在数秒内重建上下文,让开发者重新了解项目当前状态、已完成工作、待办任务与下一步动作。

主要能力

  • 检查当前目录是否存在 .cocoplus/;若不存在,输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。
  • 按固定顺序读取上下文文件:
    • .cocoplus/project.md:项目名称、目标、描述
    • .cocoplus/lifecycle/meta.json:当前阶段、已完成阶段
    • .cocoplus/lifecycle/plan.md:已批准计划(仅前 500 字符)
    • .cocoplus/flow.json:提取 status != "completed" 的待办阶段
    • .cocoplus/memory/decisions.md:最近 3 条决策记录
    • .cocoplus/grove/patterns/:模式文件列表(仅文件名)
    • .cocoplus/grove/cupper-findings.md:最近 3 条发现摘要
  • 生成叙述式 Markdown 文档,包含以下章节:
    • Welcome Back
    • Project:项目名称与目标
    • Where You Left Off:最后完成阶段、日期及 1-2 句成果概述
    • Approved Plan (excerpt):plan.md 前 500 字符
    • Pending Build Tasks:待办阶段 id、名称、分配角色;若无则显示“All stages complete.”
    • Recent Decisions:最近 3 条决策;若无则显示“No decisions recorded yet.”
    • Available Patterns:模式文件名列表;若无则显示“No patterns promoted yet.”
    • Intelligence Insights:最近 3 条 CocoCupper 发现摘要;若无则显示“No CocoCupper analysis yet.”
    • Recommended Next Action:根据当前阶段给出具体命令

使用方式

在已初始化 CocoPlus 的项目目录中触发该技能,它会读取上述状态文件并输出恢复摘要。文档未提供具体安装命令或调用命令,暂未提供。

适用场景

  • 开发者隔一段时间后重返项目,需要快速了解进度。
  • 需要基于当前阶段获得准确的下一步命令建议,而非凭记忆猜测。

限制与约束

  • 依赖 .cocoplus/ 目录及其中各类状态文件存在。
  • 设计目标为 5 秒内完成,避免缓慢的文件扫描。
  • 输出应为叙述式摘要,不应冗长罗列全部文件内容。
  • 不建议仅读取 AGENTS.md 而跳过 meta.json、flow.json、memory 等文件,因为 AGENTS.md 只是摘要。
  • 推荐下一步动作前必须检查当前阶段,例如在 Test 阶段不应推荐 $spec。
  • 文档未说明支持的平台、收费方式或版本信息,暂未提供。