docs: 完成所有文档的中文翻译并应用到项目

This commit is contained in:
xuxiang
2026-01-28 00:12:54 +08:00
parent 0ced59a26b
commit e133f58e1c
76 changed files with 6808 additions and 6170 deletions

View File

@@ -1,35 +1,35 @@
---
name: strategic-compact
description: Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.
description: 建议在逻辑间隔进行手动上下文压缩Context Compaction以便在任务阶段中保留上下文而不是依赖随机的自动压缩。
---
# Strategic Compact Skill
# 策略性压缩技能 (Strategic Compact Skill)
Suggests manual `/compact` at strategic points in your workflow rather than relying on arbitrary auto-compaction.
建议在工作流Workflow的关键点手动执行 `/compact`,而不是依赖随机触发的自动压缩。
## Why Strategic Compaction?
## 为什么需要策略性压缩?
Auto-compaction triggers at arbitrary points:
- Often mid-task, losing important context
- No awareness of logical task boundaries
- Can interrupt complex multi-step operations
自动压缩会在随机时间点触发:
- 经常在任务进行中触发,导致丢失重要的上下文
- 无法识别逻辑上的任务边界
- 可能会中断复杂的多步操作
Strategic compaction at logical boundaries:
- **After exploration, before execution** - Compact research context, keep implementation plan
- **After completing a milestone** - Fresh start for next phase
- **Before major context shifts** - Clear exploration context before different task
在逻辑边界处进行策略性压缩:
- **在探索之后,执行之前** —— 压缩研究阶段的上下文,保留实现计划
- **在完成里程碑之后** —— 为下一阶段开启全新开始
- **在重大上下文切换之前** —— 在切换到不同任务前清理探索相关的上下文
## How It Works
## 工作原理
The `suggest-compact.sh` script runs on PreToolUse (Edit/Write) and:
`suggest-compact.sh` 脚本在工具调用前PreToolUse针对 `Edit`/`Write` 工具)运行,并且:
1. **Tracks tool calls** - Counts tool invocations in session
2. **Threshold detection** - Suggests at configurable threshold (default: 50 calls)
3. **Periodic reminders** - Reminds every 25 calls after threshold
1. **跟踪工具调用** —— 统计会话Session中的工具调用次数
2. **阈值检测** —— 在达到可配置的阈值默认50 次调用)时给出建议
3. **定期提醒** —— 达到阈值后,每隔 25 次调用提醒一次
## Hook Setup
## 钩子 (Hook) 配置
Add to your `~/.claude/settings.json`:
添加至您的 `~/.claude/settings.json`
```json
{
@@ -45,19 +45,19 @@ Add to your `~/.claude/settings.json`:
}
```
## Configuration
## 配置
Environment variables:
- `COMPACT_THRESHOLD` - Tool calls before first suggestion (default: 50)
环境变量:
- `COMPACT_THRESHOLD` —— 首次建议前的工具调用次数(默认:50
## Best Practices
## 最佳实践
1. **Compact after planning** - Once plan is finalized, compact to start fresh
2. **Compact after debugging** - Clear error-resolution context before continuing
3. **Don't compact mid-implementation** - Preserve context for related changes
4. **Read the suggestion** - The hook tells you *when*, you decide *if*
1. **在规划后压缩** —— 一旦计划最终确定,进行压缩以全新状态开始执行
2. **在调试后压缩** —— 在继续开发前清理错误修复相关的上下文
3. **不要在实现过程中压缩** —— 为相关变更保留上下文
4. **关注建议** —— 钩子Hook告诉您“何时”可以压缩而“是否”压缩由您决定
## Related
## 相关资源
- [The Longform Guide](https://x.com/affaanmustafa/status/2014040193557471352) - Token optimization section
- Memory persistence hooks - For state that survives compaction
- [长篇指南 (The Longform Guide)](https://x.com/affaanmustafa/status/2014040193557471352) —— Token 优化章节
- 记忆持久化钩子 (Memory persistence hooks) —— 用于在压缩后仍需保留的状态