smith-ctx-cursor

使用/summarize命令进行光标上下文管理,通过@提及文件包含,以及@codebase发现。在Cursor IDE操作或上下文超过60%时使用。在Cursor会话中激活上下文优化。

📖 中文导读:使用/summarize命令进行光标上下文管理,通过@提及文件包含,以及@codebase发现。在Cursor IDE操作或上下文超过60%时使用。在Cursor会话中激活上下文优化。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: smith-ctx-cursor description: Cursor context management with /summarize command, @ mentions for file inclusion, and @codebase discovery. Use when operating in Cursor IDE or when context exceeds 60%. Activate for context optimization in Cursor sessions.

Cursor Context Management

  • Load if: Using Cursor, context >60%
  • Prerequisites: @smith-ctx/SKILL.md

CRITICAL: Context Commands (Primacy Zone)

Agent prompts for context status, then recommends /summarize at 60-70%.

Automatic summarization uses smaller flash model → vague summaries, lost details. Recommend manual /summarize before auto-trigger.

After any summarization:

  1. Re-state critical context (task, files, decisions)
  2. Use @ mentions to restore files: @auth/middleware.ts @auth/tokens.ts

/summarize - Manual Summarization

When to use: Before automatic trigger, between task phases

Recommendation format:

/summarize

After summarizing, re-add critical files:
@auth/middleware.ts @auth/tokens.ts

Verify summary preserved:

  • Task goals
  • File locations
  • Design decisions
  • Next steps
  • Claiming to execute /summarize directly
  • Relying solely on automatic summarization
  • Continuing without verifying summary quality

@ Mentions - Force-Include Files

Syntax: @filename or @path/to/file.ext

Use @ mentions for:

  • After summarization (restore critical files)
  • Before implementation (load files to modify)
  • Large files >600 lines (@codebase truncates at 250)

Patterns:

@auth/middleware.ts @auth/tokens.ts    # Multiple files
@src/auth.ts @tests/auth.test.ts       # File + tests
  • @codebase for files >600 lines (only loads first 250)
  • @ mention entire directories
  • @ mention files you won't use

@codebase - Discovery Only

Use for: Finding files, understanding patterns Limitation: Returns summaries, not complete code

Workflow:

  1. @codebase authentication middleware → Find files
  2. @auth/middleware.ts → Load full file
  3. Implement with complete context

.cursorrules - Persistent Instructions

Location: .cursorrules in project root

Put in .cursorrules (project-specific):

  • Technology stack
  • Project structure
  • Reference to @AGENTS.md

Put in skill files (personal/global):

  • Universal principles
  • Language style
  • Git workflow

Example:

# Project Rules
Follow standards from @AGENTS.md

## Stack
- Framework: NestJS
- Database: PostgreSQL
- Testing: Jest
  • @smith-ctx/SKILL.md - Universal context strategies

ACTION (Recency Zone)

Proactive context management:

  1. Prompt for context status
  2. At 60-70%: Recommend /summarize before auto-trigger
  3. After summarization: Remind to re-add files with @ mentions

Agent RECOMMENDS - user executes the command.

File size strategy:

  • <250 lines: @codebase works
  • 250-600 lines: Use @ mention
  • 600 lines: Always @ mention