Back to Details

ctx

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Contextualize

项目上下文梳理

You need to fully contextualize yourself in this repository before doing any work.
在开展任何工作之前，你需要全面梳理清楚当前代码仓库的上下文信息。

Step 1: Search Total Recall

步骤1：搜索Total Recall

First, search Total Recall for relevant context about this project. Use whichever tool name is available:
undefined
首先，搜索Total Recall获取与该项目相关的上下文信息。使用可用的对应工具名称：
undefined

Claude Code:

Claude Code:

mcp__plugin_totalrecall_memory-total-recall__synthesis_search({ query: "project name/key terms recent work decisions made", max_results: 15 })
mcp__plugin_totalrecall_memory-total-recall__synthesis_search({ query: "project name/key terms recent work decisions made", max_results: 15 })

Codex/other:

Codex/other:

totalrecall.synthesis_search({ query: "project name/key terms recent work decisions made", max_results: 15 })

Look for:
- Recent conversations about this project
- Decisions that were made
- Problems that were solved
- Patterns established
- Gotchas discovered
totalrecall.synthesis_search({ query: "project name/key terms recent work decisions made", max_results: 15 })

重点查找：
- 关于该项目的近期对话内容
- 已做出的决策
- 已解决的问题
- 已确立的模式
- 已发现的潜在陷阱

Step 2: Delegate Oracle for Deep Context

步骤2：委托Oracle进行深度上下文收集

Delegate an Oracle worker for deep context gathering:
teams(action: 'delegate', tasks: [{
  text: 'Contextualize yourself deeply in this repository. [see investigation checklist below]',
  assignee: 'oracle'
}])
If 
teams
is not available, perform the investigation yourself directly.
委托Oracle工作者进行深度上下文收集：
teams(action: 'delegate', tasks: [{
  text: 'Contextualize yourself deeply in this repository. [see investigation checklist below]',
  assignee: 'oracle'
}])
若
teams
功能不可用，则自行直接开展调查工作。

Investigation Checklist

调查清单

Whether delegated to Oracle or done directly, cover these areas:
  1. Project Identity
    • Read AGENTS.md, README.md, package.json (or equivalent)
    • What is this project? What does it do?
    • What are the core technologies and patterns?
    • What are the established conventions?
  2. Current Work Status
    • Check for active plan tickets (
      tk list --tag plan
      )
    • Check for pending work tickets (
      tk list
      )
    • Check git status and recent commits (git log -10 --oneline)
    • What was being worked on? What's in progress?
  3. Decision History
    • Check for decision tickets (
      tk list --tag decision
      )
    • What major decisions have been made?
    • What constraints exist from past choices?
  4. Architecture Overview
    • Map the key directories and their purposes
    • Identify core modules/services
    • Understand the data flow
  5. Pain Points & Context
    • Look for TODOs, FIXMEs, HACKs in code
    • Check for any KNOWN_ISSUES or TROUBLESHOOTING docs
    • Identify technical debt markers
无论委托给Oracle还是自行开展，都需要覆盖以下领域：
  1. 项目标识
    • 阅读AGENTS.md、README.md、package.json（或同类文件）
    • 该项目是什么？主要功能是什么？
    • 核心技术与模式有哪些？
    • 已确立的规范有哪些？
  2. 当前工作状态
    • 查看活跃的计划工单（
      tk list --tag plan
      ）
    • 查看待处理的工作工单（
      tk list
      ）
    • 检查git状态与近期提交记录（git log -10 --oneline）
    • 之前在开展什么工作？哪些工作正在进行中？
  3. 决策历史
    • 查看决策类工单（
      tk list --tag decision
      ）
    • 已做出哪些重大决策？
    • 过去的选择带来了哪些约束？
  4. 架构概述
    • 梳理关键目录及其用途
    • 识别核心模块/服务
    • 理解数据流逻辑
  5. 痛点与背景信息
    • 查找代码中的TODO、FIXME、HACK标记
    • 查看是否有KNOWN_ISSUES或TROUBLESHOOTING文档
    • 识别技术债务标记

Deliverable Format

交付格式

markdown
undefined
markdown
undefined

Project Summary

项目摘要

[What this is, in 2-3 sentences]
[用2-3句话描述项目内容]

Current Status

当前状态

  • Active work: [what's in progress]
  • Blocked items: [if any]
  • Recent changes: [last few commits summary]
  • 活跃工作：[正在进行的工作内容]
  • 阻塞项：[如有]
  • 近期变更：[最近几次提交的摘要]

Key Decisions to Remember

需要牢记的关键决策

  • [Decision 1]
  • [Decision 2]
  • [决策1]
  • [决策2]

Established Patterns

已确立的模式

  • [Pattern 1]: [where/how used]
  • [Pattern 2]: [where/how used]
  • [模式1]：[使用场景/方式]
  • [模式2]：[使用场景/方式]

Conventions & Constraints

规范与约束

  • [Convention from AGENTS.md]
  • [Technical constraint]
  • [来自AGENTS.md的规范]
  • [技术约束]

Recommended Next Steps

建议下一步行动

Based on current state, suggest what to focus on.
undefined
基于当前状态，建议重点关注的方向。
undefined

Step 3: Synthesize and Report

步骤3：整合信息并汇报

After gathering context from memory and investigation:
  1. Summarize the key findings for the user
  2. Highlight anything that seems urgent or blocked
  3. Confirm understanding of current priorities
  4. Ask if there's specific context you're missing
从Total Recall和调查工作中收集完上下文信息后：
  1. 总结关键发现并呈现给用户
  2. 突出任何看起来紧急或阻塞的事项
  3. 确认对当前优先级的理解
  4. 询问是否遗漏了特定的上下文信息

When to Use This Command

何时使用该流程

  • Starting a new session on a project
  • Returning to a project after time away
  • Before making significant changes
  • When feeling uncertain about project state
  • After another developer has made changes
Remember: Context prevents mistakes. Take the time to understand before acting.
  • 启动新项目会话时
  • 时隔多日后重返项目时
  • 进行重大变更之前
  • 对项目状态感到不确定时
  • 其他开发者完成变更之后
注意：上下文梳理能避免错误。在采取行动前，请花时间充分理解项目情况。