Agent skill

Side Story Navigation

by MaaAssistantArknights in MaaAssistantArknights/MaaAssistantArknights

新增/更新 SideStory（别传）活动关卡导航。涵盖 tasks/Stages 导航任务、StageActivityV2.json 活动配置、MaaRelease 仓库同步三个文件的联动修改。用户要求添加新活动导航、更新活动关卡、活动开放或复刻时调整导航，以及提到同步 MaaRelease 时均应使用本 skill。

AGPL-3.0Auto-check passedDevelopment

Install Side Story Navigation

skills CLI

$ npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install MaaAssistantArknights/MaaAssistantArknights side-story-navigation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/MaaAssistantArknights/MaaAssistantArknights.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/side-story-navigation .claude/skills/side-story-navigation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "side-story-navigation" agent skill from https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev-v2/.agents/skills/side-story-navigation into .claude/skills/side-story-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "side-story-navigation", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev-v2/.agents/skills/side-story-navigation

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install MaaAssistantArknights/MaaAssistantArknights side-story-navigation --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MaaAssistantArknights/MaaAssistantArknights.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/side-story-navigation .agents/skills/side-story-navigation && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "side-story-navigation" agent skill from https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev-v2/.agents/skills/side-story-navigation into .agents/skills/side-story-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "side-story-navigation", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install MaaAssistantArknights/MaaAssistantArknights side-story-navigation --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MaaAssistantArknights/MaaAssistantArknights.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/side-story-navigation .cursor/skills/side-story-navigation && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "side-story-navigation" agent skill from https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev-v2/.agents/skills/side-story-navigation into .cursor/skills/side-story-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "side-story-navigation", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/MaaAssistantArknights/MaaAssistantArknights.git --path .agents/skills/side-story-navigation

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install MaaAssistantArknights/MaaAssistantArknights side-story-navigation --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MaaAssistantArknights/MaaAssistantArknights.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/side-story-navigation .gemini/skills/side-story-navigation && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "side-story-navigation" agent skill from https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev-v2/.agents/skills/side-story-navigation into .gemini/skills/side-story-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "side-story-navigation", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install MaaAssistantArknights/MaaAssistantArknights side-story-navigation

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/MaaAssistantArknights/MaaAssistantArknights.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/side-story-navigation .github/skills/side-story-navigation && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "side-story-navigation" agent skill from https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev-v2/.agents/skills/side-story-navigation into .github/skills/side-story-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "side-story-navigation", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install MaaAssistantArknights/MaaAssistantArknights side-story-navigation --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MaaAssistantArknights/MaaAssistantArknights.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/side-story-navigation .opencode/skills/side-story-navigation && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "side-story-navigation" agent skill from https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev-v2/.agents/skills/side-story-navigation into .opencode/skills/side-story-navigation/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "side-story-navigation", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: side-story-navigation
GitHub stars: 24k
Token cost: ~2.2k tokens
SKILL.md length: 474 words
Files: 1
Skills in repo: 8
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Works in 7 steps: 术语 → 涉及的文件 → tasks… → …
Development work in your project
SKILL.md covers 用户输入格式, 必需信息清单, 0. 术语 and 1. 涉及的文件, plus 5 more sections
Calls git; reaches prts.wiki

What it does

Side Story Navigation is an agent skill from MaaAssistantArknights/MaaAssistantArknights. 新增/更新 SideStory（别传）活动关卡导航。涵盖 tasks/Stages 导航任务、StageActivityV2.json 活动配置、MaaRelease 仓库同步三个文件的联动修改。用户要求添加新活动导航、更新活动关卡、活动开放或复刻时调整导航，以及提到同步 MaaRelease 时均应使用本 skill。

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: 《明日方舟》小助手，全日常一键长草！| A one-click tool for the daily tasks of Arknights, supporting all clients. The licence is AGPL-3.0.

When your agent uses it

Development work in your project

Example prompts

“/side-story-navigation”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

术语
涉及的文件
tasks 导航文件结构（resource/tasks/Stages/XX.json）
StageActivityV2.json
MaaRelease 仓库同步（可选）
排列顺序速查
完整操作清单

What it can do on your machine

Read from SKILL.md and the folder at commit 067cc0d. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- prts.wiki
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Side Story Navigation loads about 2.2k tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 474 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~46
When it runs · the whole SKILL.md, loaded when a task matches: ~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MaaAssistantArknights/MaaAssistantArknights at commit 067cc0d, republished under its AGPL-3.0 licence (© MaaAssistantArknights). 474 words, ~2,173 tokens.

Download SKILL.mdSave it as .claude/skills/side-story-navigation/SKILL.md (or your agent's skills folder).

name: side-story-navigation
description: 新增/更新 SideStory（别传）活动关卡导航。涵盖 tasks/Stages 导航任务、StageActivityV2.json 活动配置、MaaRelease 仓库同步三个文件的联动修改。用户要求添加新活动导航、更新活动关卡、活动开放或复刻时调整导航，以及提到同步 MaaRelease 时均应使用本 skill。

SideStory 活动导航 Skill

新增或更新一个 SideStory 活动的关卡导航，涉及多个文件的联动修改。

用户输入格式

典型输入是一行式：活动 wiki 链接 + 关卡号与掉落物名称粘着的配对（搓玉关如有一并给出）：

https://prts.wiki/w/昨日海 6全新装置 7转质盐组 8液化高能气体

wiki 链接用 WebFetch 抓取，提取：活动全名、关卡开放起止时间、分期章节名（二期/三期章节名及其开放时间）。关卡前缀（关卡代号形如 YW-N）在 wiki 活动主页通常没有，可靠路径是从关卡子页面确认（如直接访问 https://prts.wiki/w/<XX>-1 验证页面存在），拿不准就向用户要。
<关卡号><材料名> 配对：材料名在 resource/item_index.json 按 name 字段反查 key，得 Drop 的 item ID。
选章三件套（方式、识别内容、roi 坐标）与进活动等待时间不在输入里，需另行向用户收集。

必需信息清单

先从用户输入与 wiki 链接提取；仍缺的向用户收集，列出缺少的项目。

#	信息项	来源	说明	示例
1	活动前缀代号 XX	wiki/用户	两字母关卡前缀；wiki 活动主页通常无关卡代号，从关卡子页面确认（访问 `prts.wiki/w/<XX>-1` 验证）或直接问用户	`TO`
2	活动全名	wiki	填入 StageActivityV2 的 Tip/StageName	`昨日海`
3	OpenOcr 识别文字	wiki	活动名、二期章节名、三期章节名（如有），见 §2.4	`昨日海, 我们的伊比利亚`
4	关卡编号列表	用户输入	通常后三关 + 可选搓玉关	`6, 7, 8` 或 `4, 6, 7, 8`
5	各关卡掉落物名称（非搓玉关）	用户输入	用于查 `item_index.json` 取 ID	`全新装置、转质盐组、液化高能气体`
6	搓玉关掉落描述（如有搓玉关）	用户	直接填入 Drop 字段，不查表	`搓玉效率0.98`
7	关卡开放时间	wiki	起止时间，用关卡关闭时间，勿用商店截止时间（见 §3.2）	`10.9 12:00 — 10.23 03:59`
8	选章方式	用户	OCR 文字 / 模板图	OCR「伊比利亚」或模板图
9	选章识别内容	用户	OCR 文字或模板图文件名；基本是第一期章节名（或其局部），但具体措辞与能否被 OCR 识别无法预判，须由用户从活动内截图确认	`伊比利亚`
10	选章 roi 坐标	用户	用户可能用 `[x, y, w, h]` 或 `x+w y+h` 两种格式之一	`[870, 560, 120, 50]` 或 `x870+120 y560+50`
11	进活动后等待时间	用户	postDelay 毫秒数，默认 5000	`5000`（等 5 秒）

若选章方式为模板图，还需额外提醒用户提供模板图片，并准备修改 MinimumRequired 版本号。

0. 术语

简称	含义
XX	活动前缀代号，如 `TD`、`TO`、`AT`，取自关卡名 `XX-7` 的前半
tasks 导航文件	`resource/tasks/Stages/XX.json`
StageActivityV2	`build/bin/Debug/cache/gui/StageActivityV2.json`（主仓库的缓存副本）
MaaRelease	上级目录 `../MaaRelease/MaaAssistantArknights/api/` 下的镜像文件

1. 涉及的文件

#	文件路径	必需性	作用
1	`resource/tasks/Stages/XX.json`	✅ 必须	关卡导航任务定义（OCR 识别活动入口、选章、找关）
2	`build/bin/Debug/cache/gui/StageActivityV2.json`	✅ 本地测试	本地构建缓存，客户端运行时从远程 API（`gui/StageActivityV2.json`）拉取，改此文件用于本地测试
3	`../MaaRelease/MaaAssistantArknights/api/gui/StageActivityV2.json`	✅ 必须	MaaRelease 远程源文件，StageActivityV2 的真正来源
4	`../MaaRelease/MaaAssistantArknights/api/resource/tasks.json`	🔶 可选	MaaRelease 精简 tasks 覆盖层（只放活动导航，依赖项由客户端本地资源提供）

2. tasks 导航文件结构（`resource/tasks/Stages/XX.json`）

参考往期活动（如 AT.json、ME.json、AveMujica.json）。

2.1 关卡范围

通常是活动的后三关（如 7/8/9、6/7/8、8/9/10），但具体关卡编号由用户提供。
可能有额外的低关卡用于搓玉（如第 4 关、第 5 关），搓玉关与后三关一并加入导航。

2.2 任务定义模板

jsonc

{
    // —— 关卡入口（按编号从小到大）——
    "XX-4": {
        "algorithm": "JustReturn",
        "sub": ["XX-4@XX-OpenOpt"],
        "next": ["XX-4@SideStoryStage", "XX-4@SwipeToStage"]
    },
    "XX-7": { ... },
    "XX-8": { ... },
    "XX-9": { ... },

    // —— 关卡识别（按编号从小到大）——
    "XX-4@SideStoryStage": { "text": ["XX-4"] },
    "XX-7@SideStoryStage": { "text": ["XX-7"] },
    "XX-8@SideStoryStage": { "text": ["XX-8"] },
    "XX-9@SideStoryStage": { "text": ["XX-9"] },

    // —— 活动入口 ——
    "XX-OpenOpt": {
        "algorithm": "JustReturn",
        "next": ["XX-OpenOcr", "XX-Open"]
    },
    "XX-Open": {
        "baseTask": "SS-Open",
        "postDelay": 5000,              // 进活动后等待时间，按需调整
        "template": ["StageSideStory.png", "StageActivity.png"],
        "next": ["XXChapterToXX"]
    },
    "XX-OpenOcr": {
        "baseTask": "SS-OpenOcr",
        "text": [...],                   // 见下方 OCR 文本规则
        "postDelay": 5000,
        "next": ["XXChapterToXX"]
    },

    // —— 选章（进入活动后选择关卡列表）——
    "XXChapterToXX": {
        // 方式 A：OCR 识别（章节名可被 OCR 时优先使用）
        "algorithm": "OcrDetect",
        "action": "ClickSelf",
        "text": ["章节名"],
        "roi": [x, y, w, h],
        "postDelay": 2000,
        "next": ["#self", "SideStoryStage", "ChapterSwipeToTheRight"]
    }
}

2.3 `XXChapterToXX` 选章任务的两种方式

方式	适用场景	algorithm
A. OCR	章节名是可识别的文字	`OcrDetect`
B. 模板图	章节名不可 OCR（特殊字体/图标）	`MatchTemplate`

方式 B 示例：

jsonc

"XXChapterToXX": {
    "action": "ClickSelf",
    "template": "XXChapterToXX.png",
    "roi": [x, y, w, h],
    "postDelay": 2000,
    "next": ["#self", "SideStoryStage", "ChapterSwipeToTheRight"]
}

⚠️ 使用模板图时的联动操作：需要新增 XXChapterToXX.png 模板图片到 resource/template/StageNavigation/SideStory/XX/ 目录，并且 必须修改 StageActivityV2.json 中的 MinimumRequired（详见 §3.3）。

2.4 OCR 文本规则

text 依次列出：活动名、二期章节名、三期章节名（如有），纯整词，不切短词。
- 示例："text": ["昨日海", "我们的伊比利亚"]
- 活动入口横幅随分期开放变化：第一期显示活动名，后续章节开放后变为对应章节名，须提前从 wiki/公告把各期章节名写全。
- 不切短词：活动名与章节名都是常用字，OCR 不存在问题，切出的短词反而有误匹配风险。

2.5 排列顺序规则

tasks 导航文件中关卡按编号从小到大排列；搓玉关放最后。

先放所有入口任务，再放所有 @SideStoryStage，最后放 Open/Chapter 相关。排列时：常规关卡按编号从小到大，搓玉关（低编号如 XX-4/XX-5，Drop 为搓玉描述）放在常规关之后。

2.6 roi 坐标

由用户提供截图坐标。格式为 [x, y, width, height]。

XXChapterToXX 的 roi 通常由用户指定形如 "x1040+150 y420+50"，即 [1040, 420, 150, 50]。

3. StageActivityV2.json

Show full SKILL.md (191 more words)Show less

3.1 位置

本地测试缓存：build/bin/Debug/cache/gui/StageActivityV2.json（客户端运行时从远程 API 拉取到本地缓存，修改此文件用于本地测试）
远程源文件：../MaaRelease/MaaAssistantArknights/api/gui/StageActivityV2.json（StageActivityV2 的真正来源，修改须 commit 推送后才对用户生效；提交/推送 MaaRelease 与主仓库一样，须先获得用户明确指令）
两者内容必须一致。

3.2 替换规则

将旧活动条目整体替换为新活动。键名为活动前缀（如 "TO"），结构如下：

jsonc

"TO": {
    "MinimumRequired": "v6.11.0",       // 见 §3.3 版本号规则
    "Activity": {
        "Tip": "SideStory「活动全名」",
        "StageName": "活动全名",
        "UtcStartTime": "2026/08/01 12:00:00",
        "UtcExpireTime": "2026/08/22 03:59:59",
        "TimeZone": 8
    },
    "Stages": [
        { "Display": "TO-9", "Value": "TO-9", "Drop": "31033" },
        { "Display": "TO-8", "Value": "TO-8", "Drop": "31013" },
        { "Display": "TO-7", "Value": "TO-7", "Drop": "30023" },
        { "Display": "TO-4", "Value": "TO-4", "Drop": "搓玉用" }
    ]
}

⚠️ 时间取关卡开放周期，不取商店周期：UtcStartTime = 活动关卡开放时刻（如 12:00:00），UtcExpireTime = 关卡关闭时刻（通常开放日起第 14 天的 03:59:59）。活动商店兑换通常比关卡多开约一周（如关卡 10/23 03:59 关、商店 10/30 03:59 关），wiki/公告里两个时间并列时勿拿商店截止时间当 ExpireTime——该字段控制关卡导航在 GUI 的有效期。

3.3 MinimumRequired 版本号规则

`XXChapterToXX` 方式	版本号处理
A. OCR（已有任务可复用）	沿用旧活动的值，通常无需改动
B. 模板图（需新增模板）	必须改为当前最新 tag 的下一个版本

模板图方式的具体操作：

查看当前最新版本号（如 git describe --tags 得到 v6.15.1）。
将 MinimumRequired 改为下一个 patch 版本（如 v6.15.2）。
通知用户复查该版本号是否正确，因为新模板图片需要随新版本客户端分发。

3.4 排列顺序规则

StageActivityV2 的 Stages 数组按编号从大到小排列。

高难关卡（高掉落价值）排在前面，搓玉等低关卡排在后面。

3.5 Drop 字段

关卡类型	Drop 取值	获取方式
后三关（常规掉落）	item_index ID（如 `"31033"`）	在 `resource/item_index.json` 中按材料名查表取 key
搓玉关等特殊关	用户提供的文字描述（如 `"搓玉效率0.98"`）	直接使用用户提供的描述，不查表

💡 知识：个别关卡可能有独立的 MinimumRequired（如某关卡需要更新版本才能解锁），可单独加到该关卡的条目中：{ "Display": "XX-4", "Value": "XX-4", "Drop": "搓玉用", "MinimumRequired": "v6.16.0" }。但用户通常不会指定，不需要主动询问。

4. MaaRelease 仓库同步（可选）

MaaRelease 仓库的同步是可选操作。用户本地可能没有拉取该仓库，或者仓库不在上级目录。操作前先检查 ../MaaRelease/ 是否存在，不存在则跳过此步骤。

4.1 前置检查

powershell

# 检查上级目录是否有 MaaRelease
Test-Path ..\MaaRelease

若存在则 git pull 更新到最新。

4.2 需要同步的文件

文件	操作
`api/gui/StageActivityV2.json`	与主仓库缓存保持一致
`api/resource/tasks.json`	将新活动导航任务放文件开头（`BlackFlowTemporary` 之前），并删除被替换旧活动的整块任务

4.3 tasks.json 追加规则

MaaRelease 的 tasks.json 是精简覆盖层，只放活动导航任务本身，不放依赖项（SS-Open、SideStoryStage、SwipeToStage、ChapterSwipeToTheRight 等基础任务由客户端本地资源提供）。
新内容放文件开头（{ 之后、第一个已有 key 之前），不是末尾。
同时删除被替换旧活动的全部任务块（旧前缀 <旧XX>- 开头的所有键）：覆盖层只保留现役活动导航，与 StageActivityV2 旧条目整体替换的语义对齐。
内容与主仓库 resource/tasks/Stages/XX.json 完全一致。

5. 排列顺序速查

文件	顺序
`resource/tasks/Stages/XX.json`	常规关卡编号从小到大，搓玉关放最后
MaaRelease `api/resource/tasks.json`	同上
`StageActivityV2.json` 的 `Stages` 数组	关卡编号从大到小（搓玉关天然在末尾）

6. 完整操作清单

✅ 解析用户输入：WebFetch wiki 链接提取活动名/前缀/关卡时间（关卡关闭时刻）/各期章节名；材料名查 item_index.json 反查 Drop ID；仍缺的选章信息向用户收集
✅ 创建/修改 resource/tasks/Stages/XX.json（导航任务，常规关卡从小到大，搓玉关放最后）
✅ 修改 build/bin/Debug/cache/gui/StageActivityV2.json（本地测试缓存，替换活动，关卡从大到小，Drop 查表或用用户描述）
- 若 XXChapterToXX 用模板图：修改 MinimumRequired 为下一个版本，通知用户复查
🔶 检查 ../MaaRelease/ 是否存在；存在则：
- cd ../MaaRelease; git pull
- 修改 api/gui/StageActivityV2.json（远程源文件，同步骤 2）
- 修改 api/resource/tasks.json（导航任务放开头、删除旧活动整块，关卡从小到大）

Files

Just SKILL.md in .agents/skills/side-story-navigation of MaaAssistantArknights/MaaAssistantArknights.

Open the folder on GitHubat commit 067cc0d

Compare with similar skills

Side Story Navigation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Side Story Navigation compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Side Story Navigation this skillMaaAssistantArknights/MaaAssistantArknights	24k	—	~2.2k	Automated safety check: Pass	AGPL-3.0	today
Vercel Composition Patternssupabase/supabase	111k	58 repos	~726	Automated safety check: Pass	MIT	today
Finishing a Development Branchobra/superpowers	297k	5 repos	~1.9k	Automated safety check: Pass	MIT	today
Typescript Advanced Typesrolling-scopes/rsschool-app	10k	25 repos	~4.2k	Automated safety check: Pass	MPL-2.0	6 days ago
PR Babysitteropeninterpreter/openinterpreter	69k	3 repos	~4.2k	Automated safety check: Pass	Apache-2.0	3 days ago
Code Review ChecklistshareAI-lab/learn-claude-code	78k	4 repos	~1.1k	Automated safety check: Pass	MIT	12 days ago

Similar skills

Vercel Composition Patterns
supabase/supabase
Official
React composition patterns that scale. An agent skill from supabase/supabase.
111k GitHub starsUsed in 58 repos~726 tokens
DevelopmentAuto-check passed
Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
297k GitHub starsUsed in 5 repos~1.9k tokens
DevelopmentAuto-check passed
Typescript Advanced Types
rolling-scopes/rsschool-app
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.
10k GitHub starsUsed in 25 repos~4.2k tokens
DevelopmentAuto-check passed
PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
69k GitHub starsUsed in 3 repos~4.2k tokens
DevelopmentAuto-check passed
Code Review Checklist
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
78k GitHub starsUsed in 4 repos~1.1k tokens
DevelopmentAuto-check passed
Greploop
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
32k GitHub starsUsed in 4 repos~3.3k tokens
DevelopmentAuto-check passed

More from MaaAssistantArknights/MaaAssistantArknights

All 8 skills in this repo

Changelog
MaaAssistantArknights/MaaAssistantArknights
依据 git 提交、diff、现有 CHANGELOG 与 tag，生成符合 MAA 规范、可直接写入 CHANGELOG.md 的最终 Markdown。用户提到发版、整理/生成 changelog、写更新日志、发布正式版或 beta 时均应使用本 skill，即使用户没有明确说出 "changelog" 一词。
24k GitHub stars~2.8k tokensUpdated today
Auto-check passed
Core Image Eval
MaaAssistantArknights/MaaAssistantArknights
用 MaaCore 本体对本地图片（用户日志反馈包截图、自己截的图）离线验证识别结果：pipeline 任务为什么没命中、模板匹配得分多少、OCR 认出了什么、物品模板匹配情况。用户提到｢验证识别｣｢为什么没识别/没命中｣｢模板分数/得分｣｢OCR 结果对不对｣｢排查反馈包截图｣或给了截图要复现 core 行为时使用。与外部脚本（python 直调 ppocr/OpenCV）的区别：本工具走…
24k GitHub stars~899 tokensUpdated today
Auto-check passed
Maa Cyber Fortune Master
MaaAssistantArknights/MaaAssistantArknights
用“赛博道士 + 故障玄学 + 半懂不懂技术分析”的风格回复 MAA 用户的简略求助。用于用户只给一句模糊问题、没有日志、没有截图、没有报错时，做一段短小离谱但认真的玄学诊断。触发词可包括“赛博算卦”“玄学回复”“评论区整活”“帮我写一段离谱但正经的故障分析”
24k GitHub stars~692 tokensUpdated today
Auto-check passed
Maa Issue Log Analysis
MaaAssistantArknights/MaaAssistantArknights
分析 MaaAssistantArknights 上游仓库公开 Issue（https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/...
24k GitHub stars~4k tokensUpdated today
Auto-check passed
Pallas Style Reply
MaaAssistantArknights/MaaAssistantArknights
以《明日方舟》帕拉斯的人设与语气生成强角色扮演式回复。用于用户明确要求“帕拉斯风格”“帕拉斯口吻”“像帕拉斯一样说话”“Pallas roleplay”时，输出带有米诺斯祭司、英雄叙事、荣誉与信念色彩的中文回复，同时保持内容可理解、可执行。
24k GitHub stars~1k tokensUpdated today
Auto-check passed
Readme Shot Demo
MaaAssistantArknights/MaaAssistantArknights
用 MAA GUI 内置演示模式（tools/ReadmeShotDemo）重新生成仓库 README 界面截图。用户提到更新/换 README 截图、README 里的画面过期、UI 大改后要更新 README 展示图、跑 ReadmeShotDemo 或 demo 截图时使用，即使用户没有明确说出｢ReadmeShotDemo｣一词。
24k GitHub stars~579 tokensUpdated today
Auto-check passed

Questions about Side Story Navigation

What does Side Story Navigation do?

When should I use Side Story Navigation?

Side Story Navigation fits situations like: development work in your project.

How do I install Side Story Navigation in Claude Code?

Run `npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a claude-code`. Or copy the skill folder (.agents/skills/side-story-navigation in MaaAssistantArknights/MaaAssistantArknights) into .claude/skills/side-story-navigation in your project. Claude Code loads it when a task matches its description.

How do I install Side Story Navigation in Codex?

Run `npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a codex`. Or copy the skill folder (.agents/skills/side-story-navigation in MaaAssistantArknights/MaaAssistantArknights) into .agents/skills/side-story-navigation in your project. Codex loads it when a task matches its description.

Can I use Side Story Navigation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MaaAssistantArknights/MaaAssistantArknights --skill side-story-navigation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/side-story-navigation, .gemini/skills/side-story-navigation, .github/skills/side-story-navigation and .opencode/skills/side-story-navigation in your project.

What does Side Story Navigation need to run?

Going by SKILL.md and its folder, Side Story Navigation needs the command-line tools its instructions call (git).

Does Side Story Navigation access the network?

SKILL.md names 1 domain. In commands or code: prts.wiki; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Side Story Navigation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Side Story Navigation use?

Side Story Navigation is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Side Story Navigation use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Side Story Navigation?

Skills that share tags, products or a category with Side Story Navigation: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Side Story Navigation?

MaaAssistantArknights (a GitHub organization) maintains it in MaaAssistantArknights/MaaAssistantArknights, which has 23,642 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on October 10, 2026.

Source: MaaAssistantArknights/MaaAssistantArknights on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Side Story Navigation

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

SideStory 活动导航 Skill

用户输入格式

必需信息清单

0. 术语

1. 涉及的文件

2. tasks 导航文件结构（resource/tasks/Stages/XX.json）

2.1 关卡范围

2.2 任务定义模板

2.3 XXChapterToXX 选章任务的两种方式

2.4 OCR 文本规则

2.5 排列顺序规则

2.6 roi 坐标

3. StageActivityV2.json

3.1 位置

3.2 替换规则

3.3 MinimumRequired 版本号规则

3.4 排列顺序规则

3.5 Drop 字段

4. MaaRelease 仓库同步（可选）

4.1 前置检查

4.2 需要同步的文件

4.3 tasks.json 追加规则

5. 排列顺序速查

6. 完整操作清单

Files

Compare with similar skills

Similar skills

More from MaaAssistantArknights/MaaAssistantArknights

Related

Questions about Side Story Navigation

2. tasks 导航文件结构（`resource/tasks/Stages/XX.json`）

2.3 `XXChapterToXX` 选章任务的两种方式