context-mate

Context Mate

一个配合 Claude Code 自然工作流的工具包。取你所需，不想用的可以忽略。

---

此技能何时激活

调用 context-mate 时，先分析项目，再推荐工具。

步骤 1：快速扫描项目

检查以下文件（使用 Glob，暂时不要读取文件内容）：

文件/模式	表示
SESSION.md	已启用会话跟踪
IMPLEMENTATION_PHASES.md	正在使用分阶段规划
PROJECT_BRIEF.md	已探索/规划项目
CLAUDE.md 或 .claude/	存在 AI 上下文
.claude/rules/	存在修正规则
package.json 或 requirements.txt	存在依赖项
tests/ 或 *.test.*	存在测试基础设施

步骤 2：Git 状态（如果是 Git 仓库）

git status --short            # Uncommitted changes?
git log --oneline -3          # Recent commit messages?

步骤 3：评估阶段并给出建议

项目阶段：

阶段	特征	建议
新项目	没有 CLAUDE.md，也没有阶段规划	/explore-idea 或 /plan-project
开发中	存在 SESSION.md 或阶段规划	/continue-session、开发者 Agent
维护模式	存在文档，没有 SESSION.md	新工作使用 /plan-feature，审查使用 project-health
会话中途	有未提交更改 + SESSION.md	继续当前工作，完成后运行 /wrap-session

步骤 4：简要输出

告诉用户：

1. 已配置的内容（例如：“你有 SESSION.md 和阶段规划——项目进行到一半”）
2. 现在可以做什么（例如：“运行 /continue-session 以继续”）
3. 可用但尚未使用的内容（例如：“还没有测试——可使用 test-runner”）

示例：

项目分析

✓ CLAUDE.md - 已配置 AI 上下文 ✓ SESSION.md - 已启用会话跟踪（正在进行第 2 阶段） ✓ .claude/rules/ - 3 条修正规则 ○ 未检测到测试文件

建议：

• 运行 /continue-session 以继续第 2 阶段的工作
• 准备提交时使用 commit-helper Agent
• 添加测试时可考虑使用 test-runner Agent

保持在 10 行以内。不要让用户应接不暇——只突出相关内容。

---

这个名称有双重含义：

1. 友好的上下文伙伴（这个工具包）
2. “关键就在上下文啊，朋友！”（这一理念）

这不是“做事的正确方式”——这些工具之所以存在，是因为上下文窗口确实有限制，而不是因为我们要规定方法论。

---

快速参考

斜杠命令（输入这些命令）

命令	功能
/context-mate	分析项目并推荐工具
/explore-idea	从一个模糊想法开始
/plan-project	规划新项目
/plan-feature	规划特定功能
/wrap-session	结束工作会话
/continue-session	从上次会话继续
/docs-init	创建项目文档
/docs-update	更改后更新文档
/brief	清除上下文前保留上下文
/reflect	将经验总结为规则、技能、记忆
/release	准备部署

Agent（Claude 会自动使用）

Agent	功能
commit-helper	编写提交消息
code-reviewer	审查代码质量
debugger	调查错误
test-runner	运行/编写测试
build-verifier	检查 dist 是否与源代码一致
documentation-expert	创建/更新文档
orchestrator	协调多步骤工作

技能（背景知识）

技能	提供内容
project-planning	基于阶段的规划模板
project-session-management	SESSION.md 模式
docs-workflow	文档维护命令
deep-debug	多 Agent 调试
project-health	AI 可读性审查
developer-toolbox	上述 7 个 Agent

---

工具包一览

┌─────────────────────────────────────────────────────────────┐
│                    PROJECT LIFECYCLE                        │
├─────────────────────────────────────────────────────────────┤
│  /explore-idea → /plan-project → [work] → /wrap-session    │
│       ↓              ↓              ↓           ↓          │
│  PROJECT_BRIEF   PHASES.md     SESSION.md   git checkpoint │
│                                     ↓                      │
│                              /continue-session             │
│                                     ↓                      │
│                              [resume work]                 │
│                                     ↓                      │
│                    /reflect → /release                     │
└─────────────────────────────────────────────────────────────┘

---

何时使用什么

你想要……	使用此项
探索一个模糊的想法	/explore-idea
规划一个新项目	/plan-project
规划一项具体功能	/plan-feature
结束工作会话	/wrap-session
休息后继续工作	/continue-session
创建/更新文档	/docs-init、/docs-update
调试棘手的问题	deep-debug 技能
审查代码质量	code-reviewer Agent
使用 TDD 运行测试	test-runner Agent
准备 git 提交	commit-helper Agent
验证构建输出	build-verifier Agent
检查文档是否便于 AI 阅读	context-auditor Agent
验证工作流是否有效	workflow-validator Agent
检查会话交接质量	handoff-checker Agent

---

组件技能

项目生命周期（project-workflow）

九个集成命令，覆盖完整的项目生命周期：

命令	用途
/explore-idea	集思广益并验证项目构想
/plan-project	生成分阶段实施计划
/plan-feature	规划一项具体功能添加
/docs-init	创建项目初始文档
/docs-update	在变更后更新文档
/wrap-session	结束会话并创建 git 检查点
/continue-session	根据 SESSION.md 继续工作
/reflect	回顾进度并规划后续步骤
/release	准备部署/发布

调用：Skill(skill: "project-workflow")

会话管理（project-session-management）

使用 SESSION.md 和 git 检查点，跨上下文窗口跟踪进度。

• 将 IMPLEMENTATION_PHASES.md 转换为可执行的跟踪事项
• 创建语义化 git 提交，作为恢复点
• 记录恢复工作所需的具体后续操作
• 防止会话之间丢失上下文

调用：Skill(skill: "project-session-management")

开发者 Agent（developer-toolbox）

七个专用 Agent，用于常见开发任务：

Agent	用途
commit-helper	生成有意义的提交消息
code-reviewer	审查安全性、质量和架构
debugger	系统化调查 bug
test-runner	执行 TDD 工作流、创建测试
build-verifier	验证 dist/ 与源代码一致
documentation-expert	创建/更新项目文档
orchestrator	协调多步骤项目

调用：Skill(skill: "developer-toolbox")

深度调试（deep-debug）

针对常规调试难以解决的顽固 bug，开展多 Agent 调查。

• 启动并行调查 Agent
• 交叉比对调查结果
• 处理浏览器/运行时问题
• 在调试陷入循环时使用效果最佳

调用：Skill(skill: "deep-debug")

质量审计（project-health）

三个 Agent，用于评估 AI 可读性和工作流质量：

Agent	用途
context-auditor	检查文档是否便于 AI 阅读（评分 0-100）
workflow-validator	验证文档中描述的流程是否有效（评分 0-100）
handoff-checker	验证会话连续性的质量（评分 0-100）

调用：Skill(skill: "project-health")

文档生命周期（docs-workflow）

四个用于文档管理的命令：

命令	用途
/docs	快速查找文档
/docs-init	创建初始文档
/docs-update	在变更后更新文档
/docs-claude	生成针对 AI 优化的 CLAUDE.md

调用：Skill(skill: "docs-workflow")

---

核心概念

会话 ≠ 阶段

会话是上下文窗口（上下文填满前可工作 2-4 小时）。

阶段是工作单元（例如“阶段 1：数据库设置”这样的逻辑分组）。

一个阶段可能跨越多个会话。一个会话也可能涉及多个阶段。它们是相互独立的概念。

带检查点的进度

Git 提交充当语义检查点，而不只是版本控制：

# Bad: commits as save points
git commit -m "WIP"
git commit -m "more changes"

# Good: commits as progress markers
git commit -m "Complete Phase 1: Database schema and migrations"
git commit -m "Phase 2 partial: Auth middleware working, UI pending"

通过 /continue-session 恢复工作时，这些提交会说明你当前进展到了哪里。

渐进式披露

技能会逐步加载，以保留上下文：

1. 元数据（约 50 个 token）——始终保留在上下文中，用于触发技能加载
2. SKILL.md 正文（少于 5,000 个单词）——技能激活时加载
3. 捆绑资源——按需加载（模板、参考资料、脚本）

这意味着，一个包含 50 项技能的工具包在实际使用之前只占用约 2,500 个 token。

技能负责指导，规则负责纠正

两种互补的知识系统：

	技能	规则
位置	~/.claude/skills/	.claude/rules/（项目）
内容	丰富的资源包	单个 Markdown 文件
用途	教你如何使用 X	纠正过时的模式
示例	如何设置 Tailwind v4	修正 Claude 可能会建议的 v3 语法

规则可跨项目移植——它们会随代码仓库一起移动，让任何 Claude 实例都能获得这些修正。

使用子 Agent 实现隔离

繁重的任务（代码审查、调试、测试）由子 Agent 执行，以便：

• 避免冗长的输出占用主上下文
• 支持并行执行
• 提供专业的工具访问权限
• 返回简洁的摘要

---

入门

新建项目

/explore-idea    # Optional: clarify what you're building
/plan-project    # Generate phased plan
                 # Work on Phase 1...
/wrap-session    # End with checkpoint

恢复工作

/continue-session    # Reads SESSION.md, suggests next steps
                     # Continue working...
/wrap-session        # Checkpoint again

添加功能

/plan-feature    # Plan the specific feature
                 # Implement...
/wrap-session    # Checkpoint

调试会话

# If normal debugging isn't working:
Skill(skill: "deep-debug")
# Spawns investigation agents

---

理念

上下文窗口是真实存在的。 它们会被填满，工作会丢失，会话会结束。

这些工具不会与之对抗——而是顺势而为：

• SESSION.md 为下次会话保存状态
• Git 检查点创建恢复点
• 子 Agent 将繁重工作隔离开来
• 渐进式披露保留上下文预算

有用的就用，不需要的就忽略。

这就是**「刀叉派」项目管理**：

传统项目管理	Context Mate
“遵循方法论”	“没事，会搞定的”
“更新甘特图”	/wrap-session
“查阅 RACI 矩阵”	“喂，Claude，接下来做什么？”

没有仪式。没有和 AI 开站会。没有燃尽图。

如果 Homer Simpson 30 秒内都搞不明白，那就太复杂了。

一切都在于上下文，伙计。 🥄