mcpField
P
project-planner

project-planner

github.com/0xdarkmatterAgent 工作流7853 次安装2 周前更新
代码仓库

关于 project-planner

用于检查 docs/PLAN.md 状态的轻量级 Agent 技能，并提示何时使用 /save 或 /sync。它能发现计划缺失或过时，但不会直接修改计划。

主要功能

  1. 01检测缺失的计划文件
  2. 02根据 Git 活动检查计划是否过时
  3. 03检查未提交的工作
  4. 04建议使用 /save 和 /sync

适用场景

  1. 01在没有项目计划时开始工作
  2. 02恢复项目会话
  3. 03对照计划检查变更
  4. 04发现需要更新的计划

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/0xdarkmatter/claude-mods --skill project-planner

安装后在 Claude Code 中输入/project-planner确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/
.gitkeep
references/
.gitkeep
scripts/
.gitkeep

详细介绍

项目规划技能

用于了解 docs/PLAN.md 状态的轻量级层。检测计划是否需要关注，并指向 /save 和 /sync 命令。

用途

此技能不会直接管理计划。它会：

  • 检测 docs/PLAN.md 是否存在
  • 识别过时的计划（与 Git 活动相比，近期没有更新）
  • 建议合适的会话命令

所有计划操作都通过 /save（持久化）和 /sync（恢复/状态）进行。

检测逻辑

缺少计划
No docs/PLAN.md found
-> Suggest: /save to create initial plan from conversation
计划过时
docs/PLAN.md last modified: 5 days ago
git log shows: 12 commits since then
-> Suggest: /sync --git to update from commits
有未提交的工作
git status shows: 5 modified files
docs/PLAN.md "In Progress" section outdated
-> Suggest: /sync --status to review
会话开始
Resuming work on project with docs/PLAN.md
-> Suggest: /sync to restore state

快速参考

情况建议
不存在计划讨论目标后使用 /save
计划已过时/sync --git
需要查看计划/sync --status
更新进度/save "notes"
重新开始/save --archive

过时判定启发式规则

符合以下条件时，计划被视为过时：

  • 上次修改距今超过 3 天，且
  • Git 显示自上次修改后有提交，且
  • 提交与计划主题相关（feat:、fix:、refactor:）

符合以下条件时，计划需要审查：

  • 会话刚刚开始
  • 存在大量未提交的更改
  • 用户提及进度或完成情况

备注

  • 此技能只提供建议，不会进行修改
  • /sync 读取状态，/save 写入状态
  • 唯一事实来源：docs/PLAN.md

评论

支持 Markdown