Agent Skills › Melvynx/Parler › sync-with-nowstack

sync-with-nowstack

GitHub

用于将项目分支与 NowStack 官方样板代码同步，保留本地修改。支持合并或变基模式，自动备份并处理冲突，确保更新安全。

web-app/.agents/skills/sync-with-nowstack/SKILL.md Melvynx/Parler

Trigger Scenarios

用户输入 /sync-with-nowstack 请求拉取最新的 NowStack 变更需要从样板仓库更新 fork

Install

npx skills add Melvynx/Parler --skill sync-with-nowstack -g -y

More Options

Non-standard path

npx skills add https://github.com/Melvynx/Parler/tree/main/web-app/.agents/skills/sync-with-nowstack -g -y

Use without installing

npx skills use Melvynx/Parler@sync-with-nowstack

指定 Agent (Claude Code)

npx skills add Melvynx/Parler --skill sync-with-nowstack -a claude-code -g -y

安装 repo 全部 skill

npx skills add Melvynx/Parler --all -g -y

预览 repo 内 skill

npx skills add Melvynx/Parler --list

SKILL.md

Frontmatter

{
    "name": "sync-with-nowstack",
    "description": "Sync an app fork with the latest NowStack boilerplate changes from melvynx\/nowstack. Use when the user types \/sync-with-nowstack, asks to pull the latest NowStack changes, or wants to update a fork from the boilerplate.",
    "argument-hint": "[--dry-run] [--rebase] [--merge] [--remote <name>] [--repo <owner\/name-or-url>] [--branch <name>] [--allow-dirty] [--no-install] [--no-verify]"
}

Sync With NowStack

Bring a project fork up to date with the canonical NowStack boilerplate while preserving local product changes.

<when_to_use> Use this workflow when:

The user types /sync-with-nowstack.
A project fork needs the latest boilerplate fixes/features from melvynx/nowstack.
A collaborator has access to the canonical repository and wants to merge those changes into their app.

Do not use this for normal feature branches that should only pull from their own app repository. </when_to_use>

<quick_start> Run the bundled script from the repository root:

.agents/skills/sync-with-nowstack/scripts/sync-with-nowstack.sh

Common options:

.agents/skills/sync-with-nowstack/scripts/sync-with-nowstack.sh --dry-run
.agents/skills/sync-with-nowstack/scripts/sync-with-nowstack.sh --rebase
.agents/skills/sync-with-nowstack/scripts/sync-with-nowstack.sh --branch main
.agents/skills/sync-with-nowstack/scripts/sync-with-nowstack.sh --repo your-org/nowstack

</quick_start>

1. Read `AGENTS.md` and the current `git status --short --branch`. 2. Run the script with any user-provided flags. 3. If the script reports conflicts, inspect them and resolve normally with Git. 4. After a successful sync, review the diff and run any extra checks needed for changed areas. 5. Add a `CHANGELOG.md` entry for local fixes made by the agent. Do not add one for upstream-only changes unless the sync itself required local edits. | Setting | Default | | --- | --- | | Remote name | `nowstack` | | Repository | `melvynx/nowstack` | | Integration mode | `merge` | | Branch | upstream default branch | | Install | enabled when dependency files change | | Verify | `pnpm ts` when `package.json` is present | - The script creates a local backup branch before merge/rebase. - It refuses to continue during an existing merge, rebase, cherry-pick, or revert. - It refuses to run with uncommitted changes unless `--allow-dirty` is passed. - It does not stash or discard local changes. - It stops on conflicts and prints the exact Git continuation command. - It never uses destructive cleanup commands.

<repo_access> The canonical repository is expected to be available at https://github.com/melvynx/nowstack.git. If GitHub returns Repository not found, confirm the collaborator has access or pass an accessible repo with --repo owner/name or --repo https://github.com/owner/name.git. </repo_access>

Version History

1aaa38b Current 2026-08-20 07:35

Metadata

Files: 0
Version: 1aaa38b
Hash: 5cdd58af
Indexed: 2026-08-20 07:35

sync-with-nowstack