first commit

productivity/minimax-m27-best-practices/SKILL.md

@@ -0,0 +1,56 @@
+---
+name: minimax-m27-best-practices
+description: MiniMax M2.7 模型使用技巧和最佳实践，确保更高效的编程体验
+version: 1.0.0
+author: Hermes Agent
+license: MIT
+metadata:
+  hermes:
+    tags: [minimax, M2.7, best-practices]
+    related_skills: [native-mcp]
+---
+
+# MiniMax M2.7 使用技巧
+
+来自官方文档：https://platform.minimaxi.com/docs/token-plan/best-practices
+
+## 核心原则
+
+### 1. 指令需明确清楚
+M2.7 对清晰明确的指令响应较好。明确说明期望的输出格式、内容和风格。
+
+### 2. 补充指令意图以提升性能
+多跟它说说"为什么"。模型理解了目的，就能更精准给出想要的答案。M2.7 会举一反三，说清楚前因后果，它就能顺着思路推理。
+
+### 3. 注重举例和细节
+- 想让它做成什么样 → 给一个标准的"样板"示例
+- 怕它犯什么错 → 明确指出来别让它做
+
+### 4. 长任务推理和状态跟踪
+- 每次聚焦有限目标，而非全量并行处理
+- 有效保障长时序下的思维连贯性与方向性
+
+### 5. 单窗口上下文感知
+- M2.7 在临近上下文容量阈值时，可能出现任务提前终止
+- 建议控制系统提示词的 tokens 数量
+- 控制整体输入输出 tokens 在 200k 以内，充分利用上下文窗口长度
+
+### 6. 多窗口工作流程
+- **分阶段处理**：第一个窗口设置框架（编写、测试、创建脚本），第二个窗口遍历待办事项
+- **结构化测试**：要求创建 `tests.py` 或 `tests.json` 跟踪测试，有助于长期迭代
+- **初始化脚本**：创建 `init.sh` 启动服务器、运行测试，避免新窗口重复操作
+- **重启 vs 压缩**：单任务用压缩，多任务或新任务建议重启全新窗口
+- **充分利用上下文**：提示 M2.7 在继续前高效完成各部分，充分利用 tokens
+
+### 推荐的 System Prompt
+```
+这是一项非常冗长的任务，建议您充分利用完整的输出上下文来处理——整体输入和输出 tokens 控制在 200k tokens，充分利用上下文窗口长度将任务彻底完成，避免耗尽 tokens。
+```
+
+## Token Plan MCP 工具
+
+使用 MiniMax Token Plan 时（主模型为 minimax_coding provider）：
+- 图片理解：`mcp_minimax_understand_image`
+- 网络搜索：`mcp_minimax_web_search`
+
+内置 `vision_analyze` 使用的 MiniMax-M2.7 有视觉 bug，应使用 MCP 工具代替。