用途
Streak 是一个通用的、灵活的挑战追踪系统，适用于 Claude Code。它可以追踪任意类型的个人挑战，并具备智能洞察与跨挑战学习检测能力。适用于学习、项目构建、健身、创作、习惯或自定义等各类挑战类型。
主要能力
Streak 通过一系列“流程”响应用户的自然语言指令，主要流程包括：
- Flow 1：新建挑战：初始化 .streak/ 文件夹，询问挑战类型（学习、构建、健身、创作、习惯或自定义）、基本信息（名称、目标、节奏：每日/每 N 天/每周）以及类型相关问题，创建预填模板文件并设为活跃挑战。
- Flow 2：签到：分为会话前（规划）与会话后（总结）两种模式。会话前加载上下文、显示状态（会话编号、连续天数、距上次天数、进度状态）、收集精力/时间等快速上下文、可选研究步骤、类型自适应点子生成，并准备会话文件夹与笔记模板。会话后（用户说“done”）进行总结提问、记录进展、更新配置与日志、生成洞察并检查成就。流程中支持“Just research”“Skip to suggestions”“I know what I'm doing”“Done/Finished/Back”“Quick check-in”等快捷指令。
- Flow 3：列出挑战：按状态分组显示，按优先级与最近签到时间排序。默认显示活跃与暂停的挑战，带 --all 标志时包含已归档挑战。
- Flow 4：切换挑战：验证挑战存在、更新 active.md、加载新挑战上下文并确认状态。
- Flow 5：统计：显示进度（会话数、开始天数、完成率）、连续记录（当前、最长、平均间隔）、模式（最佳日期、最佳时间、平均时长）、成就（获得的徽章与日期）、待办（已完成、进行中、待处理项）。
- Flow 6：跨挑战洞察：分析所有挑战，检测复合学习（一个挑战的技能促成另一个）、技能迁移（跨挑战的相同概念）、跨领域（不同类型间的关联）、模式（最佳日期、生产力趋势）以及个性化建议。
- Flow 7：日历导出：生成包含签到提醒的 .ics 文件，频率基于节奏设置，默认 30 天前瞻（可配置），兼容 Google、Apple、Outlook 日历。
- Flow 8：重置挑战：归档当前进度并重新开始，将日志归档为 challenge-log-archived-[date].md，归档会话文件夹，重置连续计数器，保留偏好、上下文与待办。
- Flow 9：暂停挑战：临时暂停（计划稍后恢复），将状态设为 paused，若暂停的是活跃挑战会提示切换。
- Flow 10：归档挑战：移至长期存储（退出日常视图），将状态设为 archived，若归档的是活跃挑战会提示切换。
- Flow 11：恢复挑战：将暂停或归档的挑战恢复为活跃，可设为当前活跃挑战；若距上次签到 7 天以上，授予“Comeback”徽章。恢复不会重置连续记录。
数据存储
所有数据保存在 .streak/ 文件夹中，结构包括全局配置（config.md）、当前挑战指针（active.md）以及每个挑战的目录（包含挑战配置、进度日志、今日上下文、待办想法、偏好、关联资源、洞察、会话笔记等）。文件模板参见 references/file-templates.md。
挑战类型
- 学习：适合课程、书籍、技能。关键问题如“有顿悟时刻吗？”“里程碑进展如何？”
- 构建：适合项目、发布。关键问题如“你发布了什么？”“有阻塞吗？”
- 健身：适合锻炼、健康。关键问题如“做了什么运动？”“身体感觉如何？”
- 创作：适合艺术、写作、音乐。关键问题如“你创作了什么？”“有灵感吗？”
- 习惯：适合日常、坚持。关键问题如“完成了吗？”“感觉如何？”
- 自定义：其他任何情况，由用户自定义问题。
类型详情参见 references/types.md。
成就系统
- 连续徽章：First Flame（3 天）、On Fire（7 天）、Unstoppable（30 天）、Diamond Streak（100 天）。
- 里程碑徽章：First Step（首次签到）、Dedicated（10 次会话）、Centurion（100 次会话）。
- 特殊徽章：Connected（首次跨挑战洞察）、Comeback（7 天以上后恢复）、Graduate（完成挑战目标）。
完整列表参见 references/achievements.md。
错误处理
- 无 .streak/ 文件夹：提示“未找到挑战。请说：开始新挑战”。
- 无活跃挑战：列出可用挑战，提示切换或新建。
- 挑战未找到：列出可用项，建议最接近的匹配。
最佳实践
- 目标要具体——“完成 Rustlings”优于“学习 Rust”。
- 从可持续开始——每 2-3 天比每日更容易坚持。
- 使用 today.md——在会话前设定上下文。
- 维护待办事项——为低精力日准备想法。
- 回顾洞察——每周检查以发现模式。
- 庆祝连续记录——成就是真实的动力。
- 无负担重置——归档是进步，不是失败。
- 交叉利用——运行多个挑战以发现联系。
参考文件
- references/file-templates.md：所有文件模板与结构。
- references/types.md：类型特定问题、偏好、点子生成。
- references/flows-detailed.md：分步流程说明。
- references/achievements.md：成就系统、洞察生成。
示例
- 30 天 AI/ML（构建）：目标为每天发布一个 AI 驱动的微应用，节奏每日，技术栈 Python、TypeScript、Claude Code。
- 学习 Rust（学习）：目标为完成 Rustlings 并构建一个 CLI 工具，节奏每 2 天，资源 Rustlings、The Rust Book。
- 晨间锻炼（健身）：目标为建立一致的力量训练习惯，节奏每日（含休息日），设备为家庭健身房——哑铃、引体向上杆。
- 每日速写（创作）：目标为 100 天每天画一幅速写，节奏每日，媒介为数字艺术（Procreate）。
- 晨间冥想（习惯）：目标为每天早上冥想 10 分钟，节奏每日，触发点为咖啡后、邮件前。