Skip to content

AllenHyang/project-manager-skill

BranchesTags

Repository files navigation

Project Manager V4.0 - Claude Code Skill

Event-Driven Project Management with automatic work capture, quality gates, and enforced workflows

一个 Claude Code Skill，提供项目管理、任务跟踪和工作日志功能。

🎯 核心特性

Event-Driven Project Management

  • 自动工作捕获: Hook-based 系统自动记录每次工具使用
  • 智能事件处理: 智能分组和日志生成
  • Know-How 提取: AI 驱动的工作模式分析
  • Git 分支集成: 从分支名自动推断任务 ID (task/123)

任务管理 + 质量门控

  • 自然语言命令: "创建任务：修复Bug"、"开始任务 123"
  • 质量检查系统: 6 维度评估（60 分制）
  • 项目规则遵循: 自动检查 .task-context.md 和 .pm/task-rules.yaml
  • Pre-flight 检查: 任务启动前的质量保证

强制工作流 + 标准格式

  • 对话式输入: AI 自然提问收集信息
  • 强制验证: 保存前自动验证格式
  • 状态机: 可追溯的工作流转换
  • 零容忍: 不可能产生低质量输出

📦 安装

快速安装（推荐）

# 1. Clone 仓库
git clone https://github.com/AllenHyang/project-manager-skill.git
cd project-manager-skill

# 2. 运行安装脚本
./install.sh

# 3. 验证安装
pm help

安装脚本会自动完成：

  1. 复制 Skill 文件到 ~/.claude/skills/project-manager/
  2. 通过 pip install -e 安装 pm 命令（editable 模式）
  3. 验证安装是否成功

手动安装

如果你想手动控制安装过程：

# 1. 复制 Skill 到 Claude 目录
mkdir -p ~/.claude/skills
cp -r skills/project-manager ~/.claude/skills/

# 2. 安装 pm CLI
cd ~/.claude/skills/project-manager
pip install -e .

# 3. 验证
pm help

卸载

./uninstall.sh

初始化项目

在你的项目目录下：

# 使用 pm 命令初始化
pm init

初始化后会创建：

your-project/
├── .project-log/
│   ├── daily-logs/          # 自动生成的日志
│   ├── decisions/           # ADR 决策记录
│   ├── reports/             # 生成的报告
│   ├── knowhow/             # 提取的经验
│   └── tasks/               # 任务管理
│       └── tasks.json
└── .pm/
    ├── events/              # 事件捕获
    └── context.json         # 当前上下文

🚀 快速开始

方式 1: 任务管理工作流（推荐）

# 在 Claude Code 中使用自然语言
"创建任务：修复邮件同步超时"
→ AI 创建任务并自动进行质量检查

"开始任务 5"
→ AI 启动任务，创建 Git 分支，运行 pre-flight 检查

"暂停任务"
→ AI 暂停当前任务

"完成任务"
→ AI 完成任务并记录

# 使用 CLI 查看状态
pm status
pm task list

方式 2: 工作日志 + ADR 工作流

在 Claude Code 中输入 /pm:

📊 Project Manager - Enforced Workflow

Available actions:
1. 📝 Log today's work        (/pm log)
2. 🏗️ Document a decision    (/pm decide)
3. 📊 Generate report         (/pm report)
4. 🔍 Check project status    (/pm status)
5. ✅ Validate project data   (/pm validate)

工作回顾

# 在 Claude Code 中
"回顾今天的工作"

# 或使用 slash 命令
/pm/review

显示：

  • Git commits
  • 完成的任务
  • Daily logs
  • 捕获的 Know-How

📋 主要命令

PM CLI 命令

pm 命令行工具提供基础操作：

命令 说明
pm init 初始化项目结构
pm status 显示项目状态
pm task list 列出所有任务
pm upgrade 检查并安装更新
pm version 显示版本号
pm help 显示帮助信息

Claude Code 自然语言命令

在 Claude Code 中使用自然语言进行完整的任务管理：

自然语言 说明
"创建任务：{title}" 创建并自动质量检查
"开始任务 123" 启动任务 + Git 分支
"暂停任务" 暂停当前任务
"完成任务" 完成当前任务
"查看任务 123" 查看任务详情
"列出任务" 列出所有任务
"回顾今天的工作" 工作总结

Claude Code Slash 命令

命令 说明
/pm 打开项目管理菜单
/pm/task/create 创建新任务
/pm/task/start 开始任务
/pm/task/done 完成任务
/pm/task/list 列出所有任务
/pm/status 快速状态检查
/pm/review 每日工作回顾
/pm/adr/create 创建架构决策记录

🎯 工作流示例

完整的任务工作流

# 1. 创建任务
"创建一个 urgent 任务：修复登录崩溃"
→ ✅ 任务 #5 已创建
→ 🔍 自动质量检查：45/60 分（良好）
→ 💡 建议：补充复现步骤和验收标准

# 2. 完善任务
"更新任务 5，补充 Bug 信息"
→ AI 智能生成完整的描述（基于上下文）

# 3. 启动任务
"开始任务 5"
→ ✅ Git 分支创建: task/5-fix-login-crash
→ ✅ Pre-flight 检查通过
→ ✅ 任务 #5 已启动

# 4. 开发过程（自动捕获）
[编辑代码、运行测试...]
→ Hook 自动捕获所有工具使用

# 5. 完成任务
"完成任务"
→ ✅ 任务 #5 已完成
→ 📝 工作已记录到 daily-logs

# 6. 回顾工作
"回顾今天的工作"
→ 显示完整的工作总结和 Know-How

🔒 质量门控

任务质量检查（6 维度）

创建任务后自动检查：

  1. 基本完整性 (10 分): 标题、描述、优先级
  2. 目的清晰度 (10 分): 明确的目标和背景
  3. 类型特定要求 (10 分): Bug 需要复现步骤，Feature 需要用户故事
  4. 验收标准 (10 分): 清晰的完成标准
  5. 项目规则遵循 (10 分): 符合 .pm/task-rules.yaml
  6. 最新关注对齐 (10 分): 符合 .task-context.md 的要求

评分等级：

  • 🟢 优秀 (50-60): 可以开始
  • 🟡 良好 (40-49): 建议改进
  • 🟠 及格 (30-39): 需要改进
  • 🔴 不足 (<30): 强烈建议改进

工作日志强制要求

  • ✅ 必须包含: type, title, details, impact
  • ✅ 类型: task, bug, refactor, optimization
  • ✅ 必须描述: 做了什么、为什么、挑战、影响

ADR 强制要求

  • ✅ 必须有 4 个部分: Context, Decision, Alternatives, Consequences
  • ✅ 必须比较 2+ 个方案及其优缺点
  • ✅ 必须记录正面和负面影响

报告强制验证

  • ✅ 生成前必须运行验证
  • ✅ 验证失败则阻止生成
  • ✅ 使用状态机: DRAFT → VALIDATING → GENERATING → PUBLISHED

🛠️ 工具脚本

脚本 说明
install.sh 安装 Skill 和 pm CLI
uninstall.sh 卸载
init-project.sh 在项目中初始化 .project-log/ 和 .pm/ 结构

📖 文档

🏗️ 项目结构

project-manager-skill/
├── skills/project-manager/       # Claude Code Skill
│   ├── SKILL.md                  # Skill 定义
│   ├── pm/                       # Python CLI 包
│   │   ├── __init__.py
│   │   └── cli/
│   │       └── main.py           # CLI 入口
│   └── setup.py                  # pip 安装配置
├── commands/pm/                  # Slash 命令
├── bin/pm                        # Bash 脚本（legacy）
├── install.sh                    # 安装脚本
├── uninstall.sh                  # 卸载脚本
└── init-project.sh               # 项目初始化脚本

🚧 系统要求

  • Python: 3.7+
  • pip: 用于安装 CLI
  • Claude Code: 支持 Skills 和 Commands
  • Git: 用于分支管理和任务 ID 推断
  • Bash: 用于运行脚本

📝 License

MIT License - see LICENSE for details

🆘 Support

Version: 4.0.0 Last Updated: 2025-12-01

About

claude-code project-manager-skill

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages