SuperAPI AI 工具集

project-planner

办公与效率

查看项目

更新于 10-15 08:33

技能介绍

用途

Project Planner 是围绕 docs/PLAN.md 的轻量级感知层,用于在项目推进过程中发现计划需要关注的情况,并提示相应的会话命令。它自身不直接管理计划内容。

主要能力

检测 docs/PLAN.md 是否存在或缺失;识别计划是否陈旧(根据最近更新时间与 git 活动对比);检查未提交的工作与计划进度是否脱节;在会话开始时提示恢复计划状态。

它只会给出建议,永不修改计划。

使用方式

所有计划操作都经由两个命令:/save 用于持久化,/sync 用于恢复状态或查看状态。

常见情境与建议对应关系:

  • 不存在计划:讨论目标后执行 /save
  • 计划陈旧:执行 /sync --git
  • 需要查看计划:执行 /sync --status
  • 更新进度:执行 /save "notes"
  • 重新开始:执行 /save --archive

触发时机

该技能在以下情况触发:同步计划、更新计划、检查状态、计划陈旧、跟踪进度、项目规划。

陈旧判断启发式

当满足以下条件时,计划被视为陈旧:最后修改时间超过 3 天前,且 git 显示自那之后有提交,且提交与计划主题相关(如 feat:、fix:、refactor:)。

当会话刚开始、存在大量未提交改动、或用户提到进度或完成情况时,计划需要审查。

适用场景

适合在会话开始或推进过程中需要了解计划是否需要更新、恢复或保存的场合,帮助保持 docs/PLAN.md 与实际开发活动一致。

限制

该技能仅提供建议,不直接修改计划;计划状态的读写分别依赖 /save 和 /sync;docs/PLAN.md 是单一事实来源。其他细节暂未提供。