Back to Details

tech-assessment

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Tech Assessment

技术评估

Generate progress reports from mentor-mentee meetings for technical assessment and continuous improvement.
从导师-学员会议中生成进度报告，用于技术评估与持续改进。

Step 1: Locate Tech Assessments Directory

步骤1：定位技术评估目录

Find the directory where tech assessment files are stored. This is typically a nested subfolder within the current working directory.
Search strategy:
  1. Use 
    Glob
    to search for 
    **/overview.md
    files containing "Tech Assessment Overview" in their content
  2. If multiple candidates exist, ask the mentor to confirm which directory to use
  3. If no candidates exist, ask the mentor for the assessments directory path
Confirmation prompt:
"Found tech assessments at 
<path>
. Is this correct, or provide the correct path."
Once located, store this path as the base for all assessment files.
找到存储技术评估文件的目录，该目录通常是当前工作目录下的嵌套子文件夹。
搜索策略：
  1. 使用
    Glob
    搜索内容包含"Tech Assessment Overview"的
    **/overview.md
    文件
  2. 如果存在多个候选目录，请让导师确认使用哪一个
  3. 如果没有找到候选目录，请向导师询问评估目录的路径
确认提示语：
"已找到技术评估目录位于
<path>
。该目录是否正确？若不正确，请提供正确路径。"
定位完成后，将该路径设为所有评估文件的基础路径。

Step 2: Identify Mentee

步骤2：识别学员

Determine the mentee's name from context or the directory structure found in Step 1.
If unclear, ask explicitly:
"Who is this tech assessment for?"
The mentee name determines the subfolder structure within the assessments directory.
从上下文或步骤1中找到的目录结构确定学员姓名。
若信息不明确，直接询问：
"本次技术评估的对象是谁？"
学员姓名将决定评估目录下的子文件夹结构。

Step 3: Load Previous Context

步骤3：加载历史上下文

Before processing new input, check for existing files:
  1. Look for 
    <mentee-name>/overview.md
  2. Find the most recent 
    *-assessment.md
    file
  3. Load both to understand:
    • Active goals and their deadlines
    • Outstanding action items
    • Previous learnings and focus areas
If no previous context exists, note this as the first assessment.
在处理新输入前，检查是否存在现有文件：
  1. 查找 
    <mentee-name>/overview.md
    文件
  2. 找到最新的 
    *-assessment.md
    文件
  3. 加载上述两个文件以了解：
    • 活跃目标及其截止日期
    • 未完成的行动项
    • 过往的学习内容和重点领域
如果没有历史上下文，标注本次为首次评估。

Step 4: Parse Input

步骤4：解析输入内容

Analyze the provided notes/transcript/summary and extract:
分析提供的会议记录/文字稿/摘要，提取以下信息：

Current Focus

当前重点

  • Projects the mentee is actively working on
  • Responsibilities they're handling
  • Areas of concentration
  • 学员正在参与的项目
  • 学员承担的职责
  • 专注的工作领域

New Learnings

新学习内容

  • Techniques: New development approaches, patterns, methodologies
  • Tools: New frameworks, libraries, software, platforms
  • Note: Learnings can come from either mentor or mentee
  • 技术方法： 新的开发思路、模式、方法论
  • 工具： 新的框架、库、软件、平台
  • 注意：学习内容可来自导师或学员任意一方

Goals Progress

目标进展

  • Goal description
  • Deadline
  • Current status (On Track / At Risk / Behind)
  • Progress notes or blockers
  • 目标描述
  • 截止日期
  • 当前状态（正常推进 / 存在风险 / 进度滞后）
  • 进展说明或障碍

Action Items

行动项

  • Task description
  • Due date
  • Owner (mentee/mentor/both)
  • Status (New / Carried Over / Completed / Overdue)
  • 任务描述
  • 截止日期
  • 负责人（学员/导师/双方）
  • 状态（新增 / 遗留 / 已完成 / 逾期）

Overdue Items

逾期项

Compare all goals and action items from previous context against today's date. Identify any that are overdue and flag them for follow-up with the mentor.
将历史上下文中的所有目标和行动项与当前日期对比，识别出逾期项并标记，以便与导师跟进。

Step 5: Identify Missing Information

步骤5：识别缺失信息

After parsing, check what's missing. If any of these cannot be inferred, prompt the mentor:
ElementPrompt if Missing
Current focus"What projects is {{mentee}} currently working on?"
New learnings"Any new techniques or tools discussed?"
Goals"What goals should we track?"
Goal deadlines"What is the deadline for {{goal}}?"
Action items"What action items were identified?"
Action item deadlines"What is the due date for {{action item}}?"
Goal status"How is {{mentee}} progressing toward each goal?"
Overdue items"The following items are overdue: {{list}}. What's the status? Should deadlines be adjusted?"
Deadline requirement: Every goal and action item must have a deadline. Always ask for deadlines if not provided.
Be specific in prompts - reference the input provided to show what was found and what's missing.
解析完成后，检查是否有信息缺失。若以下任何信息无法推断，向导师发起询问：
元素缺失时的提示语
当前重点"{{mentee}}目前正在参与哪些项目？"
新学习内容"本次讨论了哪些新的技术方法或工具？"
目标"我们需要跟踪哪些目标？"
目标截止日期"{{goal}}的截止日期是什么时候？"
行动项"确定了哪些行动项？"
行动项截止日期"{{action item}}的截止日期是什么时候？"
目标状态"{{mentee}}在每个目标上的进展如何？"
逾期项"以下项已逾期：{{list}}。当前状态如何？是否需要调整截止日期？"
截止日期要求： 每个目标和行动项都必须有截止日期，如果未提供，务必询问截止日期。
提示语需具体，引用已提供的输入内容，说明已找到的信息和缺失的信息。

Step 6: Generate Outputs

步骤6：生成输出内容

Output 1: Update 
overview.md

输出1：更新
overview.md

Update the living document using the template at assets/overview.md.
使用assets/overview.md中的模板更新动态文档。

Output 2: Create 
YYYY-MM-DD-assessment.md

输出2：创建
YYYY-MM-DD-assessment.md

Create a dated archival file using the template at assets/assessment.md.
Key elements:
  • Link to previous assessment
  • Discussion summary
  • Current focus (snapshot)
  • New learnings (snapshot)
  • Goals progress table showing previous vs current status
  • Action items (carried over + new)
  • Notes for next assessment
使用assets/assessment.md中的模板创建带日期的存档文件。
核心元素：
  • 链接至之前的评估报告
  • 讨论摘要
  • 当前重点（快照）
  • 新学习内容（快照）
  • 目标进展表格，展示过往与当前状态对比
  • 行动项（遗留项 + 新增项）
  • 下次评估的注意事项

Output 3: Microsoft Teams Message

输出3：Microsoft Teams消息

Generate a concise, friendly message for the mentee using the template at assets/teams-message.md.
Format: Markdown suitable for copying into Microsoft Teams
Include:
  • Greeting
  • Current focus (1-2 bullets)
  • New learnings (what was discussed)
  • Goals progress (status check)
  • Action items assigned to them with due dates
Tone: Encouraging, clear, actionable
使用assets/teams-message.md中的模板为学员生成简洁友好的消息。
格式： 适合复制到Microsoft Teams的Markdown格式
包含内容：
  • 问候语
  • 当前重点（1-2个项目符号）
  • 新学习内容（讨论的内容）
  • 目标进展（状态检查）
  • 分配给学员的行动项及截止日期
语气： 鼓励、清晰、可执行

File Structure

文件结构

When creating new assessment files, organize within the assessments directory identified in Step 1:
<assessments-directory>/
└── <mentee-name>/
    ├── overview.md              # Living document, update after each assessment
    ├── 2025-02-05-assessment.md # Archived assessments
    ├── 2025-02-12-assessment.md
    └── ...
Always use lowercase mentee-name with hyphens for spaces (e.g., 
john-doe
).
创建新的评估文件时，需将其组织在步骤1中定位的评估目录内：
<assessments-directory>/
└── <mentee-name>/
    ├── overview.md              # 动态文档，每次评估后更新
    ├── 2025-02-05-assessment.md # 存档的评估报告
    ├── 2025-02-12-assessment.md
    └── ...
学员姓名需使用小写，空格替换为连字符（例如：
john-doe
）。