تشغيل أي مهارة في Manus بنقرة واحدة

$pwd:

upsert-case

Name: Upsert Case
Author: AgoraIO

// Add a new API example or modify an existing one. Covers both creation and modification scenarios, including file structure, per-example storyboard creation, registration, and ARCHITECTURE.md updates.

تشغيل في Manus

$ git log --oneline --stat

stars:٣٤٣

forks:٢٣٠

updated:٢٤ أبريل ٢٠٢٦ في ١٠:٣٦

مستكشف الملفات

4 ملفات

SKILL.md

readonly

related-skills.json

نفس المستودع

review-case.md

from "AgoraIO/API-Examples"

Code review for API examples. Ensures examples follow project conventions, handle lifecycle correctly, manage threads safely, and use APIs properly.

2026-04-24343

review-case.md

from "AgoraIO/API-Examples"

Code review for API examples. Ensures examples follow project conventions, handle lifecycle correctly, manage threads safely, and use APIs properly.

2026-04-24343

upsert-case.md

from "AgoraIO/API-Examples"

Add a new API example or modify an existing one. Covers both creation and modification scenarios, including dialog class structure, registration in APIExampleDlg, localization wiring, and ARCHITECTURE.md updates.

2026-04-24343

upsert-case.md

from "AgoraIO/API-Examples"

Add a new API example case or modify an existing one in the APIExample Android demo — creates or updates Fragment class, XML layout, string resources, and nav_graph registration. Use when: adding a new Agora RTC API demo screen, modifying an existing case's implementation or registration, implementing a new feature example in Java + XML layouts, registering a new case via @Example annotation, subclassing BaseFragment for a new demo screen, or updating an existing case's strings, layout, or nav entry. Keywords: add case, modify case, update case, new fragment, nav_graph, @Example, BaseFragment, APIExample, new screen, demo case, RTC API example.

2026-03-16343

upsert-case.md

from "AgoraIO/API-Examples"

Add a new audio API example case or modify an existing one in the APIExample-Audio Android demo — creates or updates Fragment class, XML layout, string resources, and nav_graph registration. Use when: adding a new Agora audio API demo screen, modifying an existing case's implementation or registration, implementing a new audio feature example in Java + XML layouts, registering a new case via @Example annotation, subclassing BaseFragment for a new audio demo screen, or updating an existing case's strings, layout, or nav entry. This project uses voice-sdk — no video APIs available. Keywords: add case, modify case, update case, new fragment, nav_graph, @Example, BaseFragment, APIExample-Audio, audio case, voice-sdk, new screen, audio demo, upsert case.

2026-03-16343

upsert-case.md

from "AgoraIO/API-Examples"

Add a new API example case or modify an existing one in the APIExample-Compose Android demo — creates or updates a Kotlin Composable file, registers or updates it in Examples.kt, and manages string resources. Use when: adding a new Agora RTC API demo screen in Jetpack Compose, modifying an existing case's implementation or registration, porting an existing APIExample case to Compose, implementing a new feature example in Kotlin + Compose UI, registering a new entry in BasicExampleList or AdvanceExampleList, or updating an existing case's strings or Examples.kt entry. Kotlin only — no XML layouts, no Fragments. Keywords: add case, modify case, update case, new composable, Examples.kt, BasicExampleList, AdvanceExampleList, APIExample-Compose, Compose case, new screen, Jetpack Compose, RTC API example, upsert case.

2026-03-16343

package.json

"author": "AgoraIO"

"repository": "AgoraIO/API-Examples"

فتح مستودع GitHub عرض مستودعات المنشئ

$ install --global

$ download --local

تشغيل في Manus

$ useful --forSOC

مطوّرو البرمجياتمهن الحاسوب والرياضيات15-1252L4

name	upsert-case
description	Add a new API example or modify an existing one. Covers both creation and modification scenarios, including file structure, per-example storyboard creation, registration, and ARCHITECTURE.md updates.
compatibility	["Cursor","Kiro","Windsurf","Claude","Copilot"]
license	MIT
metadata	{"author":"APIExample Team","version":"1.0.0","platform":"macOS"}

Upsert Case Skill — macOS

When to Use

Use this skill when you need to:

Create a new API example (case)
Modify an existing example
Ensure the example is properly registered and documented

Applicable Scenarios

Scenario 1: Create a New Example

Trigger: User requests a new API demo (e.g., "Add a screen sharing example")

Steps:

Determine if the example belongs in Basic/ or Advanced/
Create the example folder with PascalCase name
Create the Swift implementation file
Create the example storyboard
Register the example in ViewController.swift
Update ARCHITECTURE.md Case Index
Verify compilation and functionality

Scenario 2: Modify an Existing Example

Trigger: User requests changes to an existing example (e.g., "Update JoinChannelVideo to support token")

Steps:

Locate the example in APIExample/Examples/[Basic|Advanced]/<ExampleName>/
Modify the Swift file
Modify the storyboard if outlets, actions, or controller identifiers changed
Update ARCHITECTURE.md Case Index if APIs changed
Verify compilation and functionality

Files to Modify

New Example

File	Action	Notes
`APIExample/Examples/[Basic\|Advanced]/<ExampleName>/<ExampleName>.swift`	Create	Main implementation file
`APIExample/Examples/[Basic\|Advanced]/<ExampleName>/Base.lproj/<ExampleName>.storyboard`	Create	Example UI and controller identifier
`APIExample/ViewController.swift`	Modify	Register example in menu/list
`ARCHITECTURE.md`	Modify	Add entry to Case Index

Modify Existing Example

File	Action	Notes
`APIExample/Examples/[Basic\|Advanced]/<ExampleName>/<ExampleName>.swift`	Modify	Update implementation
`APIExample/Examples/[Basic\|Advanced]/<ExampleName>/Base.lproj/<ExampleName>.storyboard`	Modify if needed	Keep outlets and controller identifiers aligned
`ARCHITECTURE.md`	Modify	Update Case Index if APIs changed

Step-by-Step Guide

Step 1: Determine Example Category

Basic: Simple, single-feature examples (JoinChannelVideo, JoinChannelAudio)
Advanced: Complex features, multi-API examples (ScreenShare, CustomVideoSource)

Step 2: Create Example Folder

mkdir -p APIExample/Examples/[Basic|Advanced]/<ExampleName>

Example folder name must be PascalCase and match the class name.

Step 3: Create Swift Implementation

Create APIExample/Examples/[Basic|Advanced]/<ExampleName>/<ExampleName>.swift

Use the template from references/example-template.swift as a starting point. Replace <ExampleName> with your example name.

Step 4: Create the Example Storyboard

Create APIExample/Examples/[Basic|Advanced]/<ExampleName>/Base.lproj/<ExampleName>.storyboard.

The storyboard name must match the value passed to NSStoryboard(name:bundle:) from ViewController.swift, and the main controller identifier in the storyboard must match the controller field in MenuItem.

Step 5: Register in ViewController

Edit APIExample/ViewController.swift and add the example to the menu/list:

MenuItem(name: "Example Name".localized,
         identifier: "menuCell",
         controller: "<ExampleName>",
         storyboard: "<ExampleName>")

Place it in the correct section (Basic / Advanced).

Step 6: Update ARCHITECTURE.md

Add a new row to the Case Index table in ARCHITECTURE.md:

| ExampleName | `Examples/[Basic|Advanced]/ExampleName/` | `api1()`, `api2()`, `api3()` | Brief description of what this example demonstrates |

Key APIs column: List 2-5 core SDK methods used in this example.

Step 7: Verify

Code compiles without errors
Example appears in the menu/list
Example can join channel and receive callbacks
leaveChannel() and destroy() are called on close
UI updates happen on main thread
Storyboard loads with the expected controller identifier
ARCHITECTURE.md Case Index is updated

Code Patterns

See references/ directory for code patterns:

lifecycle-pattern.swift — Proper engine lifecycle
thread-safety-pattern.swift — Thread-safe UI updates

NEVER List

Do NOT:

Forget to call destroy() — this causes engine leaks
Update UI directly from delegate callbacks — always use DispatchQueue.main.async
Create multiple engine instances in one example — use a single shared instance
Use Objective-C files — Swift only
Use UIKit or SwiftUI — Cocoa (AppKit) only
Hardcode App ID or token — use KeyCenter
Forget to implement AgoraRtcEngineDelegate for event handling
Leave the channel without calling leaveChannel() first
Modify examples outside the APIExample/Examples/[Basic|Advanced]/ structure
Register a new menu item without also creating the per-example storyboard under the same example folder
Forget to update ARCHITECTURE.md Case Index after adding/modifying an example

Verification Checklist

After completing the upsert, verify:

References

Template files: See references/ directory for Swift code templates
Existing examples: Review APIExample/Examples/Basic/JoinChannelVideo/ for reference implementation
SDK documentation: Refer to Agora RTC SDK for macOS documentation for API details

upsert-case

المزيد من هذا المستودع

المزيد من هذا المستودع

Upsert Case Skill — macOS

When to Use

Applicable Scenarios

Scenario 1: Create a New Example

Scenario 2: Modify an Existing Example

Files to Modify

New Example

Modify Existing Example

Step-by-Step Guide

Step 1: Determine Example Category

Step 2: Create Example Folder

Step 3: Create Swift Implementation

Step 4: Create the Example Storyboard

Step 5: Register in ViewController

Step 6: Update ARCHITECTURE.md

Step 7: Verify

Code Patterns

NEVER List

Verification Checklist

References

Upsert Case Skill — macOS

When to Use

Applicable Scenarios

Scenario 1: Create a New Example

Scenario 2: Modify an Existing Example

Files to Modify

New Example

Modify Existing Example

Step-by-Step Guide

Step 1: Determine Example Category

Step 2: Create Example Folder

Step 3: Create Swift Implementation

Step 4: Create the Example Storyboard

Step 5: Register in ViewController

Step 6: Update ARCHITECTURE.md

Step 7: Verify

Code Patterns

NEVER List

Verification Checklist

References