cass-memory

CASS Memory - 上下文学习系统

构建并使用一套从你的会话中学习到的编码模式个人手册。

前置条件

cm 命令行应可用（属于 cass-memory 系统）。

初始化：

cm init
# Or with a starter playbook
cm init --starter typescript
cm init --starter react
cm init --starter python
cm init --starter go

命令行参考

获取某项任务的上下文

# THE main command - get relevant rules before starting work
cm context "Description of your task" --json

返回内容：

• 你的手册中的相关规则
• 需要避免的反模式
• 类似过往工作的历史片段

反思（提取模式）

# Run reflection on recent sessions
cm reflect --json

# Specify lookback period
cm reflect --days 7 --json
cm reflect --days 30 --json

手册管理

# List all rules
cm playbook list --json

# Get specific rule details
cm playbook get b-8f3a2c --json

# Add a new rule
cm playbook add "Always use optional chaining for nested object access" --json

对规则的反馈

# Mark rule as helpful
cm mark b-8f3a2c --helpful --json
cm mark b-8f3a2c --helpful --reason "Prevented null error" --json

# Mark rule as harmful
cm mark b-8f3a2c --harmful --json
cm mark b-8f3a2c --harmful --reason "Caused false positive" --json

记录会话结果

# Record success
cm outcome --status success --json
cm outcome --status success --rules "b-8f3a2c,b-4d2e1f" --json

# Record failure
cm outcome --status failure --text "Build failed due to type error" --json

# Mixed results
cm outcome --status mixed --text "Partial completion" --json

统计

# Get playbook stats
cm stats --json

顶级规则

# Show most effective rules
cm top --json
cm top 5 --json
cm top 20 --json

健康检查

# Check system health
cm doctor --json

# Auto-fix issues
cm doctor --fix --json

查找过时规则

# Rules without recent feedback
cm stale --json
cm stale --days 30 --json
cm stale --days 60 --json

验证规则

# Validate a proposed rule against history
cm validate "Proposed rule text" --json

解释规则来源

# Show evidence and reasoning for a rule
cm why b-8f3a2c --json

使用统计

cm usage --json

入门手册

# List available starters
cm starters --json

工作流模式

会话开始

# Get context before starting a task
cm context "Implement user authentication with JWT" --json

工作过程中

当某条规则有帮助时：

cm mark b-8f3a2c --helpful --json

当某条规则导致误入歧途时：

cm mark b-8f3a2c --harmful --reason "Not applicable to this framework" --json

会话结束

# Record outcome
cm outcome --status success --rules "b-8f3a2c,b-4d2e1f" --json

定期维护

# Weekly: Run reflection to extract new patterns
cm reflect --days 7 --json

# Monthly: Review stale rules
cm stale --days 30 --json

# Check system health
cm doctor --json

构建你的手册

# Manually add a pattern you've learned
cm playbook add "Use React.memo() for components receiving complex objects as props" --json

# After adding, use it in context queries
cm context "Create a list component with filtering" --json

规则生命周期

1. 创建 - 规则来自反思或手动添加
2. 使用 - 规则在上下文查询中出现
3. 反馈 - 根据经验标记为有帮助/有害
4. 演化 - 高反馈的规则上升，低反馈的规则变得过时
5. 淘汰 - 过时规则会被审查并清除

最佳实践

1. 始终先获取上下文 - 在开始工作前运行 cm context "task"
2. 提供反馈 - 将规则标记为有帮助/有害
3. 记录结果 - 跟踪会话成功/失败
4. 定期运行反思 - 每周反思可提取新模式
5. 审查过时规则 - 不要让旧规则不断累积
6. 手动添加规则 - 当你学到重要内容时

集成技巧

任务前上下文

在任何重要的编码任务之前：

CONTEXT=$(cm context "Your task description" --json)
# Use context to inform your approach

会话后记录

在编码会话结束时：

cm outcome --status success --text "Completed feature X" --json