# claude-code-longterm-planner **Repository Path**: haohandongku/claude-code-longterm-planner ## Basic Information - **Project Name**: claude-code-longterm-planner - **Description**: 仿扣子的长期计划的访谈skill - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-03-27 - **Last Updated**: 2026-03-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 技术架构说明 ## 系统架构图 ``` ┌─────────────────────────────────────────────────────────────┐ │ 用户交互层 │ │ • Claude Code CLI / Web 界面 │ │ • 自然语言输入（"我想制定一个学习计划"） │ │ • 命令输入（/tasks, /done, /adjust） │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ Skill 引擎层 │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 意图识别模块 │ │ │ │ • 关键词匹配（学习/习惯/项目/考试/健身/创作） │ │ │ │ • 周期估算（8-12周/66天/按里程碑） │ │ │ └─────────────────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────┐ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 诊断引擎（5维画像） │ │ │ │ • 目标定位（Goal） │ │ │ │ • 时间投入（Time） │ │ │ │ • 学习风格（Style） │ │ │ │ • 现有基础（Baseline） │ │ │ │ • 资源约束（Resource） │ │ │ └─────────────────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────┐ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 决策规则引擎 │ │ │ │ • 目标→阶段映射表 │ │ │ │ • 时间→任务密度映射 │ │ │ │ • 风格→资源形式映射 │ │ │ │ • 基础→难度校准 │ │ │ └─────────────────────────────────────────────────────┘ │ ↓ ┌─────────────────────────────────────────────────────────────┐ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 模板渲染引擎 │ │ │ │ • 加载对应模板（stock-learning/habit-building等） │ │ │ │ • 填充用户画像数据 │ │ │ │ • 生成个性化计划 │ │ │ └─────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ Task 管理层 │ │ • 自动创建 Task 任务链（Day 0 → Week 1 → ...） │ │ • 设置依赖关系（blocked-by / blocks） │ │ • 状态跟踪（pending → in_progress → completed） │ │ • 跨会话持久化（~/.claude/tasks/） │ │ • 提醒设置（/loop 集成） │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ 数据层 │ │ • Skill 文件（.claude/skills/longterm-planner/SKILL.md） │ │ • 模板库（templates/*.md） │ │ • Task 数据（~/.claude/tasks/） │ │ • 用户画像（运行时内存） │ └─────────────────────────────────────────────────────────────┘ ``` ## 核心组件详解 ### 1. Skill 文件（SKILL.md） **职责：** - 定义触发条件（用户意图识别） - 实现诊断流程（5维画像收集） - 封装决策规则（映射表） - 提供输出模板 **关键设计：** ```yaml --- name: longterm-planner description: | 通用长期计划制定与管理系统... 支持计划类型：技能学习、习惯养成、项目执行... --- # 触发条件 ## 当用户表达以下需求时自动激活： - "我想学习..." - "我想养成...习惯" ... # 核心流程（必须顺序执行） ## Phase 1: 意图识别与类型判定 ## Phase 2: 诊断性访谈（5维画像） ## Phase 3: 画像确认 ## Phase 4: 生成计划架构 ## Phase 5: 创建 Task 任务 ``` ### 2. 模板系统 **模板结构：** ```markdown --- name: template-name category: skill-learning | habit-formation | project-management | ... duration: X weeks | X days difficulty: beginner | intermediate | advanced | adaptive --- # 模板标题 ## 适用画像 - 目标定位：... - 时间投入：... - 学习风格：... - 现有基础：... ## 阶段路线图 ... ## Week 0 启动包 ... ## 每周执行SOP ... ## 检查点与调整 ... ``` **模板选择逻辑：** ```python def select_template(plan_type, user_profile): templates = { 'skill-learning': ['stock-learning', 'language-learning', 'coding-learning'], 'habit-formation': ['habit-building'], 'project-management': ['project-execution'], 'exam-prep': ['exam-preparation'], 'health-fitness': ['fitness-goal'], 'creative-work': ['content-creation'] } # 根据用户画像选择最合适的模板 # 考虑：目标、时间、风格、基础 return best_match_template ``` ### 3. 决策规则引擎 **规则类型：** #### A. 目标 → 阶段设计映射 ``` 零基础入门 → 概念建立 → 简单应用 → 综合练习 → 巩固验收 实战应用 → 工具掌握 → 场景模拟 → 真实项目 → 复盘优化 系统掌握 → 框架学习 → 模块深入 → 整合应用 → 教学输出 专业精通 → 前沿研究 → 创新实践 → 方法论提炼 → 领域影响 ``` #### B. 时间 → 任务密度映射 ``` 微习惯（1-2h/周） → 每天1个微任务（5-15分钟） 轻量（2-4h/周） → 每周3个任务（20-30分钟/个） 标准（4-8h/周） → 每周4-5个任务（30-60分钟/个） 强化（8-15h/周） → 每周5-7个任务（60-120分钟/个） ``` #### C. 风格 → 资源形式映射 ``` 阅读研究 → 书籍/文章/研报 + 思维导图 视听学习 → 视频课程/播客 + 笔记整理 实践操作 → 项目/练习/模拟 + 复盘总结 社交互动 → 小组学习/导师指导 + 讨论记录 游戏化 → 挑战任务/积分系统 + 成就追踪 ``` #### D. 基础 → 难度校准 ``` 完全新手 → 起点难度：1/10，进阶速度：慢，容错空间：大 概念了解 → 起点难度：3/10，进阶速度：中等，容错空间：中 轻度实践 → 起点难度：5/10，进阶速度：快，容错空间：中 经验积累 → 起点难度：7/10，进阶速度：很快，容错空间：小 进阶优化 → 起点难度：9/10，进阶速度：自适应，容错空间：极小 ``` ### 4. Task 管理系统 **Task 结构：** ```json { "id": "task-uuid", "description": "任务描述", "status": "pending | in_progress | completed | blocked", "tag": ["plan-name", "week1", "checkpoint"], "blocked_by": ["task-id-1", "task-id-2"], "blocks": ["task-id-3"], "due": "2026-04-01", "remind": "3 days", "metadata": { "plan_type": "skill-learning", "week": 1, "estimated_time": "45min", "deliverable": "交付物描述" } } ``` **Task 创建流程：** ``` 用户确认计划 ↓ 创建主计划 Task（tag: longterm） ↓ 创建 Day 0 Tasks（tag: setup） ↓ 创建 Week 1-N Tasks（tag: week{N}） ↓ 创建阶段检查点 Tasks（tag: checkpoint） ↓ 设置依赖关系（Day 0 → Week 1 → Week 2 ...） ↓ 设置提醒（/loop 集成） ``` ### 5. 状态管理 **对话状态机：** ``` [Idle] → 用户输入 "我想..." → [IntentRecognition] ↓ [Diagnosis] → 顺序提问5个维度 → [ProfileConfirmation] ↓ [PlanGeneration] → 生成计划 → [TaskCreation] ↓ [Execution] → 用户执行任务 → [Checkpoint] ↓ [Adjustment] → 根据反馈调整 → [Execution] ``` **数据持久化：** - **Skill 配置**：`.claude/skills/longterm-planner/`（版本控制） - **Task 数据**：`~/.claude/tasks/`（跨会话持久化） - **用户画像**：运行时内存（每次对话重新收集或从 Task metadata 恢复） ## 扩展机制 ### 1. 添加新模板 **步骤：** 1. 创建 `templates/new-template.md` 2. 遵循模板规范（YAML frontmatter + 必需章节） 3. 在 SKILL.md 中添加模板选择逻辑 4. 测试验证 ### 2. 自定义决策规则 **编辑 SKILL.md：** ```markdown ### 自定义规则 | 条件 | 动作 | |------|------| | 如果用户时间 < 2h/周 | 强制使用微习惯模式 | | 如果用户基础 = 完全新手 | 增加 Week 0 长度 | | 如果用户风格 = 游戏化 | 增加积分/徽章机制 | ``` ### 3. 集成外部工具 **通过 MCP (Model Context Protocol)：** ```python # 搜索学习资源 /mcp-search "Python 学习资源 初学者" # 生成学习文档 /mcp-generate-doc "Week 1 学习笔记" # 设置日历提醒 /mcp-calendar "add event '雅思模拟考试' on 2026-04-01" # 数据分析 /mcp-analyze "分析我的 Task 完成率趋势" ``` ## 性能优化 ### 1. 上下文管理 - 使用渐进式披露，避免一次性输出过多信息 - 关键决策点确认后再生成详细计划 - Task 系统分担状态管理，减少上下文负担 ### 2. 模板缓存 - 模板文件加载后缓存，避免重复读取 - 用户画像缓存，支持对话内快速调整 ### 3. 延迟加载 - 只加载当前需要的模板 - 后续周的 Tasks 可以延迟创建（按需） ## 安全与隐私 ### 数据安全 - Task 数据存储在用户本地（`~/.claude/tasks/`） - 用户画像不离开当前会话（除非显式保存） - 支持数据导出/备份 ### 隐私保护 - 不收集敏感个人信息 - 计划内容仅用于生成 Task，不用于模型训练 - 支持本地运行，无需联网（除 MCP 工具外） ## 部署方式 ### 方式1：本地开发（推荐） ```bash # 克隆到本地项目 git clone cp -r .claude /path/to/your/project/ # 启动 Claude Code，自动加载 Skill ``` ### 方式2：团队共享 ```bash # 将 Skill 提交到团队仓库 git add .claude/skills/longterm-planner/ git commit -m "Add longterm planner skill" git push # 团队成员拉取后自动可用 ``` ### 方式3：分发安装 ```bash # 打包分发 zip -r longterm-planner.zip .claude/ # 用户解压到项目根目录即可使用 ``` ## 监控与调试 ### 日志记录 ```python # Skill 执行日志 [2026-03-26 10:00:00] Intent recognized: skill-learning [2026-03-26 10:00:05] Diagnosis started: goal positioning [2026-03-26 10:02:30] Profile confirmed: {user_profile} [2026-03-26 10:02:35] Template selected: stock-learning [2026-03-26 10:02:40] Tasks created: 15 ``` ### 调试命令 ```bash # 查看 Skill 加载状态 /claude --skill longterm-planner --status # 重新加载 Skill /claude --skill longterm-planner --reload # 调试模式（显示决策过程） /claude --skill longterm-planner --debug ``` ## 未来演进 ### v1.1 规划 - [ ] 模板市场（社区贡献模板） - [ ] AI 辅助模板生成（根据描述自动生成模板） - [ ] 多模态支持（图片/视频计划展示） ### v1.2 规划 - [ ] 智能调整（基于完成数据自动优化计划） - [ ] 预测分析（预测完成概率，提前干预） - [ ] 社交功能（计划分享、 accountability 伙伴） ### v2.0 规划 - [ ] 独立应用（Web/App 界面） - [ ] 云端同步（多设备同步计划） - [ ] AI 教练（主动提醒、智能建议）