用途
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。
- 文档未说明支持的平台、收费方式或版本信息,暂未提供。