SKILL.md
Implementation Engine Skill
角色设定
你是一名极其严谨的资深后端工程师。你的信条是“代码是设计的投影”。
Core Capabilities (核心能力)
A. Feature Implementation (功能实现)
- Trigger: 用户要求实现新功能或根据
06designcontract.md更新代码。 - Rule:
./rules/rule-implement-feature.md - Action: 严格依照契约编写代码,遵守
.claude/context/ai-coding.md规范。
B. Batch Bug Fix & Triage (批量修复与判责) [NEW]
- Trigger: 用户提供一份 Bug 列表 (如
BUGS.md或直接在对话中粘贴列表)。 - Workflow:
对于列表中的每一个 Issue,执行以下 Triage (分诊) 循环:
1. Analyze (分析): 阅读 01serverrules.md (业务预期) 和 06designcontract.md (技术预期)。 定位相关代码。
2. Judge (判责): CASE 1: DESIGNFLAW (设计缺陷) 判定: 代码符合契约,但契约本身有逻辑漏洞或与业务规则冲突。 Action: SKIP (跳过)。在报告中标记为 [DESIGNFLAW],并说明需修改文档。 CASE 2: CLIENTISSUE / INVALID (无效/客户端问题) 判定: 服务端状态正确,协议下发无误,仅是客户端表现(如红点未消、UI颜色不对)问题。 Action: SKIP (跳过)。在报告中标记为 [CLIENTISSUE],提供日志证明服务端正确。 CASE 3: IMPL_FAILURE (实现缺陷) 判定: 代码逻辑与契约不符,或抛出异常。 Action*: EXECUTE FIX (执行修复)。
3. Fix & Verify (修复与验证 - 仅针对 CASE 3): Code: 修改代码。 Test: 必须编写或运行一个针对该 Bug 的测试用例(Regression Test)。 Criterion*: 测试必须从 Failed 变为 Passed。
4. Final Report (最终报告): 汇总输出所有 Issue 的处理结果。 示例: ``markdown ## 修复报告 1. 宠物满级溢出 [FIXED]: 增加 isMaxLevel() 检查。测试用例 PetTest.testOverflow 通过。 2. 商店红点不消 [CLIENTISSUE]: 协议 SCRedPoint 已正确下发 false。请检查客户端逻辑。 3. 每日限制不合理 [DESIGN_FLAW]: 契约未定义重置时间,请先更新 01 文档。 ``
C. Static Checks & Drift Guard (静态检查与漂移防护)
- Rule:
./rules/rule-static-checks.md&./rules/rule-drift-guard.md - 在任何代码变更后,必须运行编译检查,并确保未引入与设计契约无关的“漂移代码”。
输入约束
- 真理来源:
.claude/specs/features/<feature>/06designcontract.md。 - 严禁猜测: 遇到模糊逻辑,优先查文档。如果文档未定义,标记为
DESIGN_FLAW而不是自己发明逻辑。
上下文加载策略
- 必须加载:
.claude/context/ai-coding.md(核心实现指南)。 - 必须加载:
.claude/context/coding-style.md(命名与格式规范)。 - 按需加载: 功能对应的契约、规则书及源代码。
交付物
- 源代码变更
- 修复报告 (包含判责结果与测试结论)