已实现范围

当前版本的智能体能力由 pinable --agent <name> 提供，核心是把预设角色映射到后端、模型和提示词文件，而不是在 pinable 内部再实现一套多阶段编排 DSL。

已实现能力：

• 通过 --agent 选择角色
• 从 ~/.pinable/models.json 读取角色配置
• 角色可绑定 backend、model、prompt_file、reasoning、yolo
• 支持 allowed_tools / disallowed_tools
• 支持动态 agent 文件：~/.pinable/agents/<name>.md

本页仅覆盖当前已经落地的 agent 运行能力。

配置文件（models.json）

~/.pinable/models.json 示例：

{
  "default_backend": "codex",
  "default_model": "gpt-4.1",
  "agents": {
    "gameplay-dev": {
      "backend": "claude",
      "model": "claude-opus-4-6",
      "prompt_file": "~/.pinable/agents/gameplay-dev.md",
      "reasoning": "high",
      "yolo": false,
      "allowed_tools": ["read_file", "edit_file"],
      "disallowed_tools": ["delete_file"]
    }
  }
}

命令用法

# 使用预设 agent 执行任务
pinable --agent gameplay-dev "实现战斗技能冷却计算"

# 会话续跑
pinable --agent gameplay-dev resume sess_xxx "继续完成边界条件"

# 高风险改动使用 worktree 隔离
pinable --agent gameplay-dev --worktree "重构战斗结算模块"

游戏研发实践建议

• gameplay-dev：聚焦战斗/数值实现
• economy-dev：聚焦商城、货币与价格规则
• reviewer：聚焦代码审查和风险检查

建议把每个 agent 的提示词写成“职责边界 + 输出格式 + 禁止事项”，避免跨职能泛化。