cass-memory

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CASS Memory - Contextual Learning System

CASS Memory - 上下文学习系统

Build and use a personal playbook of coding patterns learned from your sessions.

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

Prerequisites

前提条件

The

cm

CLI should be available (part of cass-memory system).

Initialize:

bash

cm init

需安装

cm

CLI（属于cass-memory系统的一部分）。

初始化：

bash

cm init

Or with a starter playbook

或使用入门手册

cm init --starter typescript cm init --starter react cm init --starter python cm init --starter go

undefined

cm init --starter typescript cm init --starter react cm init --starter python cm init --starter go

undefined

CLI Reference

CLI参考

Get Context for a Task

获取任务上下文

bash

undefined

bash

undefined

THE main command - get relevant rules before starting work

核心命令 - 开始工作前获取相关规则

cm context "Description of your task" --json


This returns:
- Relevant rules from your playbook
- Anti-patterns to avoid
- History snippets from similar past work

cm context "你的任务描述" --json


该命令返回：
- 手册中的相关规则
- 需要避免的反模式
- 类似过往工作的历史片段

Reflection (Extract Patterns)

反思（提取模式）

bash

undefined

bash

undefined

Run reflection on recent sessions

对近期会话进行反思

cm reflect --json

Specify lookback period

指定回溯周期

cm reflect --days 7 --json cm reflect --days 30 --json

undefined

cm reflect --days 7 --json cm reflect --days 30 --json

undefined

Playbook Management

手册管理

bash

undefined

bash

undefined

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

undefined

cm playbook add "嵌套对象访问始终使用可选链操作符" --json

undefined

Feedback on Rules

规则反馈

bash

undefined

bash

undefined

Mark rule as helpful

标记规则为有帮助

cm mark b-8f3a2c --helpful --json cm mark b-8f3a2c --helpful --reason "Prevented null error" --json

cm mark b-8f3a2c --helpful --json cm mark b-8f3a2c --helpful --reason "防止了空值错误" --json

Mark rule as harmful

标记规则为有害

cm mark b-8f3a2c --harmful --json cm mark b-8f3a2c --harmful --reason "Caused false positive" --json

undefined

cm mark b-8f3a2c --harmful --json cm mark b-8f3a2c --harmful --reason "导致了误判" --json

undefined

Record Session Outcomes

记录会话结果

bash

undefined

bash

undefined

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

cm outcome --status failure --text "因类型错误导致构建失败" --json

Mixed results

记录混合结果

cm outcome --status mixed --text "Partial completion" --json

undefined

cm outcome --status mixed --text "部分完成" --json

undefined

Statistics

统计信息

bash

undefined

bash

undefined

Get playbook stats

获取手册统计数据

cm stats --json

undefined

cm stats --json

undefined

Top Rules

Show most effective rules

显示最有效的规则

cm top --json cm top 5 --json cm top 20 --json

undefined

cm top --json cm top 5 --json cm top 20 --json

undefined

Health Check

健康检查

bash

undefined

bash

undefined

Check system health

检查系统健康状况

cm doctor --json

Auto-fix issues

自动修复问题

cm doctor --fix --json

undefined

cm doctor --fix --json

undefined

Find Stale Rules

查找过时规则

bash

undefined

bash

undefined

Rules without recent feedback

无近期反馈的规则

cm stale --json cm stale --days 30 --json cm stale --days 60 --json

undefined

cm stale --json cm stale --days 30 --json cm stale --days 60 --json

undefined

Validate Rules

验证规则

bash

undefined

bash

undefined

Validate a proposed rule against history

根据历史记录验证拟议规则

cm validate "Proposed rule text" --json

undefined

cm validate "拟议规则文本" --json

undefined

Explain Rule Origin

解释规则来源

bash

undefined

bash

undefined

Show evidence and reasoning for a rule

显示规则的依据和推理过程

cm why b-8f3a2c --json

undefined

cm why b-8f3a2c --json

undefined

Usage Statistics

使用统计

bash

cm usage --json

bash

cm usage --json

Starter Playbooks

入门手册

bash

undefined

bash

undefined

List available starters

列出可用的入门手册

cm starters --json

undefined

cm starters --json

undefined

Workflow Patterns

工作流模式

Session Start

会话开始

bash

undefined

bash

undefined

Get context before starting a task

开始任务前获取上下文

cm context "Implement user authentication with JWT" --json

undefined

cm context "使用JWT实现用户认证" --json

undefined

During Work

工作中

When a rule helps:

bash

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

When a rule leads astray:

bash

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

当规则有帮助时：

bash

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

当规则误导时：

bash

cm mark b-8f3a2c --harmful --reason "不适用于此框架" --json

Session End

会话结束

bash

undefined

bash

undefined

Record outcome

记录结果

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

undefined

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

undefined

Periodic Maintenance

定期维护

bash

undefined

bash

undefined

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

undefined

cm doctor --json

undefined

Building Your Playbook

构建你的手册

bash

undefined

bash

undefined

Manually add a pattern you've learned

手动添加你学到的模式

cm playbook add "Use React.memo() for components receiving complex objects as props" --json

cm playbook add "为接收复杂对象作为props的组件使用React.memo()" --json

After adding, use it in context queries

添加后，在上下文查询中使用它

cm context "Create a list component with filtering" --json

undefined

cm context "创建带筛选功能的列表组件" --json

undefined

Rule Lifecycle

规则生命周期

Creation - Rules emerge from reflection or manual addition
Usage - Rules surface in context queries
Feedback - Mark as helpful/harmful based on experience
Evolution - High-feedback rules rise, low-feedback rules become stale
Retirement - Stale rules get reviewed and pruned

创建 - 规则通过反思或手动添加产生
使用 - 规则在上下文查询中显示
反馈 - 根据使用体验标记为有帮助/有害
演化 - 高反馈规则优先级提升，低反馈规则变为过时
淘汰 - 过时规则被审核并移除

Best Practices

最佳实践

Always get context first - Run
```
cm context "task"
```
before starting work
Provide feedback - Mark rules as helpful/harmful
Record outcomes - Track session success/failure
Run reflection regularly - Weekly reflection extracts new patterns
Review stale rules - Don't let old rules accumulate
Add rules manually - When you learn something important

始终先获取上下文 - 开始工作前运行
```
cm context "任务"
```
提供反馈 - 标记规则为有帮助/有害
记录结果 - 跟踪会话的成功/失败
定期运行反思 - 每周反思提取新模式
审核过时规则 - 不要积累旧规则
手动添加规则 - 当你学到重要内容时

Integration Tips

集成技巧

Pre-Task Context

任务前上下文

Before any significant coding task:

bash

CONTEXT=$(cm context "Your task description" --json)

在任何重要编码任务前：

bash

CONTEXT=$(cm context "你的任务描述" --json)

Use context to inform your approach

使用上下文指导你的方法

undefined

undefined

Post-Session Recording

会话后记录

At end of coding session:

bash

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

编码会话结束时：

bash

cm outcome --status success --text "完成功能X" --json

cass-memory

Original

Translation

CASS Memory - Contextual Learning System

CASS Memory - 上下文学习系统

Prerequisites

前提条件

Or with a starter playbook

或使用入门手册

CLI Reference

CLI参考

Get Context for a Task

获取任务上下文

THE main command - get relevant rules before starting work

核心命令 - 开始工作前获取相关规则

Reflection (Extract Patterns)

反思（提取模式）

Run reflection on recent sessions

对近期会话进行反思

Specify lookback period

指定回溯周期

Playbook Management

手册管理

List all rules

列出所有规则

Get specific rule details

获取特定规则详情

Add a new rule

添加新规则

Feedback on Rules

规则反馈

Mark rule as helpful

标记规则为有帮助

Mark rule as harmful

标记规则为有害

Record Session Outcomes

记录会话结果

Record success

记录成功

Record failure

记录失败

Mixed results

记录混合结果

Statistics

统计信息

Get playbook stats

获取手册统计数据

Top Rules

热门规则

Show most effective rules

显示最有效的规则

Health Check

健康检查

Check system health

检查系统健康状况

Auto-fix issues

自动修复问题

Find Stale Rules

查找过时规则

Rules without recent feedback

无近期反馈的规则

Validate Rules

验证规则

Validate a proposed rule against history

根据历史记录验证拟议规则

Explain Rule Origin

解释规则来源

Show evidence and reasoning for a rule

显示规则的依据和推理过程

Usage Statistics

使用统计

Starter Playbooks

入门手册

List available starters

列出可用的入门手册

Workflow Patterns

工作流模式

Session Start

会话开始

Get context before starting a task