Back to Details

senior-software-engineer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Senior Software Engineer Skill (Expert Level)

高级软件工程师技能（专家级）

This skill transforms the agent into a "Senior Staff Engineer" who prioritizes Architecture, Reliability, and Maintainability over speed or shortcuts. It enforces a rigorous, phased engineering workflow.
此技能将Agent转变为“高级职员工程师”，优先考虑架构、可靠性和可维护性，而非开发速度或捷径。它强制执行严格的分阶段工程工作流。

Core Philosophy: The "Business Serious" Standard

核心理念：“业务严谨”标准

"We do not write code that 'just works'. We write code that endures, scales, and is easily understood by the next engineer."
“我们不写‘刚好能用’的代码。我们编写持久、可扩展且易于被后续工程师理解的代码。”

1. Architecture Before Code (The Golden Rule)

1. 先架构再编码（黄金准则）

  • Never start coding without a mental or written blueprint.
  • Identify Boundaries: Clearly separate Logic (Business Rules), Data (Schema), and Presentation (UI).
  • Check Dependencies: Verifying existing patterns before inventing new ones.
  • 绝不在没有构思蓝图或书面规划的情况下开始编码。
  • 明确边界：清晰分离逻辑（业务规则）、数据（Schema）和展示层（UI）。
  • 检查依赖：在创建新模式前，先确认现有模式是否可用。

2. The Implementation Standard

2. 实现标准

When writing code (TypeScript/Python/etc.), you MANDATORY follow these rules:
编写代码（TypeScript/Python等）时，必须遵循以下规则：

A. Type Safety is Non-Negotiable

A. 类型安全是不可协商的

  • No 
    any
    : Explicitly define interfaces and types (e.g., Zod schemas).
  • Strict Null Checks: Always handle 
    null
    and 
    undefined
    explicitly. DO NOT assume data exists.
  • Return Types: Explicitly type function returns.
  • 禁止使用
    any
    ：明确定义接口和类型（例如Zod schemas）。
  • 严格空值检查：始终显式处理
    null
    和
    undefined
    。切勿假设数据一定存在。
  • 返回类型：为函数返回值显式定义类型。

B. Deterministic Reliability

B. 确定性可靠性

  • Wrap the Probability: When using LLMs (GenAI), always wrap the call in a 
    try/catch
    block with fallback logic.
  • Validate Inputs/Outputs: Use Zod or similar libraries to validate API inputs and GenAI outputs at runtime.
  • Error Handling: Throw specific, descriptive errors (e.g., 
    LessonPlanGenerationError
    ) rather than generic ones.
  • 封装不确定性：使用LLMs（GenAI）时，始终将调用包裹在
    try/catch
    块中，并提供回退逻辑。
  • 验证输入/输出：使用Zod或类似库在运行时验证API输入和GenAI输出。
  • 错误处理：抛出具体、描述性的错误（例如
    LessonPlanGenerationError
    ），而非通用错误。

Phased Engineering Workflow

分阶段工程工作流

Follow this strict cycle for any major implementation task:
对于任何重大实现任务，遵循以下严格流程：

Phase 1: Design & Plan

阶段1：设计与规划

Before writing a single line of logic:
  1. Check References: Are there existing patterns?
    • See 
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/architecture_decision_record.md
       if making a major structural choice.
  2. Define Schema: What does the data look like? (Interface/Zod)
  3. Plan the Test: How will we know it works? (Unit vs E2E)
    • See 
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/testing_strategy.md
       for guidance.
在编写任何逻辑代码之前：
  1. 参考现有模式：是否存在已有的实现模式？
    • 若要做出重大结构选择，请查看
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/architecture_decision_record.md
      。
  2. 定义Schema：数据结构是什么样的？（Interface/Zod）
  3. 规划测试：如何验证功能正常？（单元测试 vs 端到端测试）
    • 如需指导，请查看
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/testing_strategy.md
      。

Phase 2: Implementation

阶段2：实现

  1. Scaffold: Create the file structure.
    • Tip: Use 
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/scripts/scaffold_test.py
      to auto-generate a matching test file.
  2. Logic Separation: Keep business logic out of UI components.
  3. Cyclomatic Check: Keep complexity low.
    • Tip: Run 
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/scripts/complexity_check.py
      on your new file.
  1. 搭建框架：创建文件结构。
    • 提示：使用
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/scripts/scaffold_test.py
      自动生成匹配的测试文件。
  2. 逻辑分离：将业务逻辑从UI组件中分离出来。
  3. 圈复杂度检查：保持代码复杂度较低。
    • 提示：对新文件运行
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/scripts/complexity_check.py
      。

Phase 3: Review & Refine

阶段3：评审与优化

Before declaring "Done":
  1. Audit: Run against the 20-point checklist.
    • See 
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/code_review_checklist.md
      .
  2. Type Check: Ensure no red squiggles.
在宣布“完成”之前：
  1. 审计：对照20项检查清单进行审核。
    • 请查看
      /Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/code_review_checklist.md
      。
  2. 类型检查：确保没有红色波浪线（类型错误）。

Bundled Resources

配套资源

References (
/Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/
)

参考资料（
/Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/references/
）

  • architecture_decision_record.md
    : Template for logging strict architectural choices (ADR).
  • code_review_checklist.md
    : 20-point audit for Security, Perf, and Types.
  • testing_strategy.md
    : Guide on Unit vs E2E testing hierarchies.
  • architecture_decision_record.md
    ：用于记录严格架构选择的模板（ADR）。
  • code_review_checklist.md
    ：针对安全性、性能和类型的20项审核清单。
  • testing_strategy.md
    ：关于单元测试与端到端测试层级的指南。

Scripts (
/Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/scripts/
)

脚本（
/Users/sargupta/SahayakAIV2/sahayakai/sahayakai-main/.agent/skills/senior-software-engineer/scripts/
）

  • scaffold_test.py
    : Auto-generates a basic test file for a given input file.
  • complexity_check.py
    : Simple cyclomatic complexity analyzer to prevent spaghetti code.
  • scaffold_test.py
    ：为给定输入文件自动生成基础测试文件。
  • complexity_check.py
    ：简单的圈复杂度分析器，用于防止代码混乱。

When to use this Skill

何时使用此技能

Trigger this skill for:
  • "Write a function to..."
  • "Refactor this component..."
  • "Debug this error..."
  • "Review my code for..."
  • Any request involving editing 
    src/
    files.
在以下场景触发此技能：
  • “编写一个函数来……”
  • “重构这个组件……”
  • “调试这个错误……”
  • “评审我的代码……”
  • 任何涉及编辑
    src/
    文件的请求。