安装程序会设置：

• 在 sessions/hooks/ 中的钩子文件，用于强制执行 DAIC
• 在 sessions/api/ 中的 API 命令，用于状态和配置管理
• 在 sessions/protocols/ 中的协议模板，用于工作流自动化
• 在 .claude/agents/ 中的专业代理，用于处理复杂操作
• 在 .claude/commands 中的会话 API 包装斜杠命令
• 初始状态文件 sessions/sessions-state.json
• 配置文件 sessions/sessions-config.json
• 自动添加运行时文件到 .gitignore

安装完毕后（可选启动教程），使用触发短语来控制工作流程：

您： “mek: 添加用户认证”
Claude： [创建任务并弹出交互式提示]

您： “start^: @sessions/tasks/h-implement-user-auth.md”
Claude： [加载上下文，提出包含具体待办事项的实施方案]

您： “yert”
Claude： [仅执行已批准的待办事项]

您： “finito”
Claude： [完成任务：提交、合并、清理]

这些触发短语是默认设置。 您也可以添加自己喜欢的触发短语：

# 查看当前触发短语
/sessions config triggers list

# 向任意类别添加自己的短语
/sessions config triggers add go lets do this

# 类别：go, no, create, start, complete, compact
# 斜杠命令 API 语法：/sessions [子系统] [命令] [参数]
# 上下文感知的帮助信息——即使命令失败也能获得指导

查看 sessions/sessions-config.json 可以了解所有配置选项。

如果没有额外的支撑结构，您往往需要手动将文件添加到上下文中，这会占用大约 20% 的上下文窗口空间，并且总是担心不得不压缩上下文。

需要记住的事情清单可能会变得很长：

• 在令牌耗尽前进行压缩
• 批准之前仔细阅读每个差异
• 编写任务文件
• 提交更改
• 合并分支
• 推送到远程仓库
• 管理 Claude 可以使用的工具
• 记住要运行正确的斜杠命令

认知负担迅速增加。

任务无法在重启后继续。关闭 Claude Code 再打开，您就需要从头解释一切。既没有信心工作能够顺利进行，也没有一个清晰的结构来处理跨上下文窗口的工作。

您发现问题的速度比解决问题的速度更快。 如果没有一种标准化、无摩擦的方式来记录任务，这些洞察就会消失。

当上下文被自动压缩时，它并不能保留足够的细节来让人放心。

大多数人都有一个 CLAUDE.md 文件，里面塞满了各种行为规则，有些简单，有些则是复杂的条件逻辑分支。

LLM 在整个对话过程中很难遵循长长的指令列表。随着对话的推进，指导效果会逐渐减弱。

Git 工作流也带来了持续的摩擦：创建分支、编写提交信息、完成时合并、推送到远程仓库。这些都增加了更多的认知负担。

因此，cc-sessions 解决了所有这些问题。

讨论-对齐-执行-检查（DAIC）

Claude 要获得编写代码的权限，必须先通过一系列严格的流程。默认情况下，编辑、编写和多编辑工具均被完全锁定。在 Claude 能够接触您的代码库之前，他必须先讨论自己的方案、阐明理由，并提出具体的待办事项清单；这些待办事项需要您使用诸如“开始吧”或“照做”之类的触发短语明确批准（可完全自定义）。

一旦您批准了计划，Claude 会加载这些精确的待办事项，并且只能在您同意的内容范围内工作。如果您试图在过程中随意更改计划，系统会立即检测到并将其强制返回到讨论模式。因此，既不会出现范围蔓延，也不会有意外的代码重写——您只会看到经过批准的工作内容。

即使重启也能保持完整性的任务管理

任务以 Markdown 文件形式存储，文件头部包含元数据，用于跟踪任务状态、分支信息以及成功标准。系统会自动创建对应的 Git 分支，严格执行分支规范（不允许向错误分支提交或在未检出分支的情况下编辑文件），并在数天后重新启动任务时，自动加载完整的上下文信息。

基于目录的任务支持复杂的多阶段工作及子任务流程；而基于文件的任务则适用于聚焦单一目标的场景。通过任务索引，您可以按服务领域进行筛选。所有内容都会在会话重启后依然保留。

专精代理助力繁重任务

五个专用代理运行在独立的上下文窗口中，负责处理那些原本会占用主进程资源的操作：

• 上下文收集：分析您的代码库，为每个新创建的任务生成全面的上下文清单。
• 日志记录：按时间顺序整合工作日志。
• 代码评审：检查实现的质量与编码规范。
• 上下文优化：根据会话中的新发现动态更新任务上下文。
• 服务文档：维护各服务的 CLAUDE.md 文件。

每个代理都会接收完整的对话记录，并将结构化结果返回到您的主会话中。

自动化工作流的协议机制

预构建的协议模板指导任务的创建、启动、完成以及上下文压缩等环节。这些协议会根据您的配置自动调整，无需您手动决定子模块、提交风格或 Git 工作流等问题。协议会自动识别您的偏好并采取相应行动。

所有协议都采用结构化的输出格式（如 [PROPOSAL]、[STATUS]、[PLAN]），让您始终清楚 Claude 何时需要您的输入。

Sessions API 与斜杠命令

统一的 sessions 命令提供了对状态、配置和任务管理的程序化访问接口。而斜杠命令（/sessions）则通过 Claude Code 的命令面板为您提供快捷操作入口。

您可以通过干净的 API 配置触发短语、管理 Git 设置、切换功能选项、查看当前状态等，API 还支持 JSON 格式的输出，便于脚本化操作。

交互式快速入门引导

首次安装时，系统会进入交互式引导模式，提供两种选择：完整模式（15–30 分钟，涵盖所有功能并配有动手练习）和仅子代理模式（5 分钟，快速定制代理）。您将在实践中学习，而非单纯阅读文档。

系统会在引导过程中自我学习，并在完成后清理现场。

完整的配置控制

所有行为均可通过 sessions/sessions-config.json 文件进行配置。您可以自定义触发短语、禁用的工具、Git 工作流（提交风格、自动合并、自动推送）、环境设置以及功能开关等。系统会自动尊重您的偏好——协议会相应调整，执行规则也会动态变化，一切都会按照您的方式运行。

自动状态保存

系统会在更新前备份您的工作，在重新安装时保留任务文件和代理自定义设置，并在会话重启后维持原有状态。您的 .gitignore 文件也会自动配置，确保运行时状态不会被纳入版本控制。所有内容都会持久化保存，绝不会丢失。