finalize

最终检查

工作原理

此技能会运行一份通用检查清单，然后检查项目的 Agent 指令文件（CLAUDE.md，或使用 AGENTS.md 的 harness），了解项目特有的最终检查要求（查找“Finalize Checklist”部分或类似内容）。项目最清楚自身的需求；此技能只负责确保没有遗漏。

不依赖特定 harness。 这份检查清单与工具无关：使用 harness 提供的 shell 和工具，运行项目实际使用的 lint、测试和构建命令。提及特定工具的步骤（例如 Impeccable UI 检查或 Memory 步骤）仅在存在该工具时适用；如果没有，则跳过并注明。这里的任何步骤都不需要子 Agent。

通用检查清单

逐项完成各部分，并报告通过的项目和需要修复的问题。 直接修复问题，不要只列出问题——用户希望你完成工作，而不只是提交报告。

1. Lint 和格式

运行项目使用的 lint/格式工具。查看 CLAUDE.md/AGENTS.md 或 package.json/Gemfile，确认相应命令。

2. 测试

运行项目的测试套件。检查以下内容：

• 所有测试均通过
• 不应跳过的测试没有被跳过
• 新代码有测试覆盖（如果没有，请注明）

3. 代码质量检查

扫描变更文件，查找常见问题：

• 应使用项目工具或常量的原始值/硬编码值
• 与现有代码不一致的模式（命名、结构、风格）
• 死代码、冗余逻辑、遗留的 TODO/FIXME 注释
• 调试语句（console.log、binding.pry、debugger、puts）
• 安全问题：硬编码密钥、不安全模式

4. 文档

检查新增或变更的代码是否有相应文档：

• 如果面向用户的行为发生变化，请更新 README 或文档页面
• 为公共 API 添加内联文档（JSDoc、YARD、文档字符串）
• 任何项目特有文档（查看 CLAUDE.md/AGENTS.md 中的清单）

5. UI 和设计质量

如果变更集不包含视图/模板/组件文件，请跳过本部分。

对变更的视图文件运行 Impeccable 技能：

• $impeccable audit <target> — 检查无障碍性、性能、响应式行为和主题
• $impeccable polish <target> — 进行最终 UI 质量检查：间距、交互状态、排版、过渡效果、与组件库的适配情况、设计系统规范遵循情况和设计令牌

报告运行了哪些 Impeccable 命令以及检查结果。直接修复问题。

与现有页面保持一致（Impeccable 未涵盖的内容）：

• 新页面应与类似的现有页面保持结构一致
• 标题、内容容器和操作按钮的位置应遵循既有模式
• 如果页面偏离主要模式，该偏离应是有意为之且理由充分

视觉验证：

• 确认变更在开发服务器、Storybook 或 Lookbook 中渲染正确
• 适用时检查浅色模式和深色模式
• 适用时检查移动端/响应式效果

6. Git 和议题管理

• PR 描述应反映变更的实际范围
• 在 PR 正文中使用 Closes #N 或等效写法关联议题
• 如果这是更大任务的一部分，请更新上级议题/史诗
• 为推迟处理或新发现的工作创建后续议题
• 将议题添加到项目看板并设置正确状态

7. 项目特有检查

阅读项目的 CLAUDE.md/AGENTS.md，查找“Finalize Checklist”部分（或类似内容）。如果存在，也请完成其中的检查项。这些是项目特有的要求，通用检查清单无法涵盖。

8. 知识

• 将值得长期保留的经验、决策或模式记录在仓库文档中，并在 CLAUDE.md/AGENTS.md 中添加指向该文档的链接