Agent skills 在开发中的实践：一次构建，处处复用

.
└── .coco/
    └── skills/
        └── skill-name/
            ├── SKILL.md          # 核心入口（必需）
            ├── reference.md      # 详细参考文档（可选）
            ├── examples.md       # 完整的请求与响应示例（可选）
            └── scripts/
                └── lint.py       # 用于自动检查的辅助脚本（可选）

---
name: I18n_Sync

description: 自动同步最新的多语言文案（i18n keys）并添加到项目中。关键词:多语言、i18n、localization、文案 key、多语言 key
---

## 流程
### 1. 执行同步脚本
首先运行 i18n 同步脚本获取最新文案,如果失败直接停止并输出原因：
```bash
swift ./Scripts/I18nSync.swift
```

### 2. 检查更新的文案
查看 `/Development_Pods/SAAdaptor/CN/Resources/zh/iOS.json` 文件的 diff，确认有新的文案 key 被拉取：

```bash
git diff /Development_Pods/SAAdaptor/CN/Resources/zh/iOS.json
```

这会显示类似以下的新增文案：
```json
"parallel_selfie_loading" : "加载中",
"parallel_selfie_loadingtitle" : "加载失败",
```

### 3. 解析用户需要的文案
找到用户提供的需要新增的 key ，随后将其添加到LocalizationKey.swift，即使该文件已有对应同样中文的key，上一步拉取到了新的也需要添加新的key。

### 4. 添加到 LocalizationKey.swift
在 `/Development_Pods/SAInfra/Sources/Localization/LocalizationKey.swift` 文件中添加新的 localization key。

**格式规则：**
```swift
public static let {key_name} = "{key_name}".localized
```

**插入位置：**
- 找到合适的位置（建议按字母顺序或功能模块分组）
- 在现有的 `public static let` 声明中添加新行

**示例：**
```swift
public static let parallel_selfie_loading = "parallel_selfie_loading".localized
public static let parallel_selfie_loadingtitle = "parallel_selfie_loadingtitle".localized
```

### 5. 验证
确认以下内容：
- [ ] iOS.json 文件中新增了对应的 key 和中文文案
- [ ] LocalizationKey.swift 中正确添加了对应的key
- [ ] 格式符合现有代码规范
- [ ] 没有重复的 key

## Notes
- 确保在项目根目录执行命令
- 添加 key 时保持代码格式一致性
- 建议按功能模块组织新增的 key

## 涉及文件

- `./Scripts/I18nSync.swift` - 同步脚本
- `/Development_Pods/SAAdaptor/CN/Resources/zh/iOS.json` - 中文文案文件
- `/Development_Pods/SAInfra/Sources/Localization/LocalizationKey.swift` - Key 定义文件

编写一份skill，项目所有成员可以不需要找人沟通、不需要看文档、不需要理解、也不需要写代码，一句话完成开发。

---
name: add-input-tool-item
description:  MessageInputToolBar (输入框工具栏/加号面板) 新增功能按钮 (PlayToolItem) 的开发指南。当需要在消息输入工具栏(输入框工具栏/加号面板)中增加新项时，使用此技能。
---

## 流程

### 1. 定义 Action 类型与埋点
*   **文件**: `SAGameMiddleware/Sources/InputView/ToolBar/MessageInputToolBarAction.swift`,enum PlayToolType定义在story.thrift文件中
*   **操作**:
    1.  在 `MessageInputToolBarActionType` 枚举中新增 `case <NewItem>`。
    2.  在 `trackClickName` 计算属性的 switch 语句中，为 `.<NewItem>` 添加对应的埋点字符串（例如 `"<tracking_name>"`）。

### 2. 映射服务端类型与红点逻辑
*   **文件**: `SAGameMiddleware/Sources/InputView/ToolBar/MessageInputToolBarItem.swift`
*   **操作**:
    1.  在 `extension MessageInputToolBarActionType` 的 `from(playToolType:)` 方法中，将服务端下发的 `PlayToolType.<NewItem>` 映射到客户端的 `.<NewItem>`。
    2.  在 `extension MessageInputToolBarItem` 的 `shouldShowRed(_:storyId:)` 方法中，新增 `case .<NewItem>` 分支。
        *   *逻辑*: 定义红点展示规则（例如：查询 `AdvancedPlayStateManager`、特定 RedDotService，或直接返回 `.none`）。默认定义为展示新功能引导红点，即此处使用以下逻辑：
           if toolBarItem.needGuide && !AdvancedPlayStateManager.shared.hasPlayed(for: toolBarItem.playToolKey, version: toolBarItem.playToolVersion) {
                return .onlyDot
            } else {
                return .none
            }

### 3. 视图层事件分发
*   **文件**: `SAGameMiddleware/Sources/InputView/InputViews/MessageInputView+Attachment.swift`
*   **操作**:
    1.  在 `handleToolAction(_:)` 方法的 switch 语句中添加 `case .<NewItem>`。
    2.  *逻辑*:
        *   返回 `false` (推荐): 如果业务逻辑需要在 VC/Controller 层处理（如弹窗、跳转）。
        *   返回 `true`: 如果逻辑仅在 InputView 内部处理（如打开相册选择器）。

### 4. 业务层点击事件响应 (Delegate 实现)
*   **涉及文件** (根据业务场景选择):
    *   `BotPlayViewController.swift` (Bot 玩法)
    *   `MainFeedContainerViewController.swift` (feed流)
    *   `StoryPlayViewController.swift` (story场景)
*   **操作**:
    1.  找到实现 `FullScreenMessageInputMenuDelegate` 协议的 `fullScreenInputView(_:didSelectMenu:)` 方法。
    2.  在 switch 语句中新增 `case .<NewItem>:`。
    3.  实现具体的点击跳转或业务逻辑（例如 `Router.shared.open(...)` 或 `Handler.open(...)`）。

### 5. 配置与过滤
*   **文件**: `SAGameMiddleware/Sources/Setting/ABTest/Values/ABTestValue+AttachmentMessage.swift`
*   **注意**: `getToolBarItems` 确保服务端下发的配置能正确通过过滤逻辑