@namewta/speculo 2.0.5 → 2.1.0

package/skills-hub/coding/github-repo-steward/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ting'an Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills-hub/coding/github-repo-steward/SKILL.md

@@ -0,0 +1,48 @@
+---
+name: github-repo-steward
+description: 盘点个人 GitHub 仓库和 star，规划或执行具名归档、删除、star/unstar，并诊断 gh/PAT 权限。用于账号级整理；不处理代码修改、普通 issue 或 PR 创建。
+license: MIT
+compatibility: Requires GitHub CLI (gh), confirmed account/host and network; inventory.sh additionally requires Bash.
+metadata:
+  author: NAMEWTA
+  wta-format-reviewed: '2026-10-06'
+---
+# GitHub 仓库管家
+
+## 输入与输出契约
+
+明确账号/host、可见仓库范围与模式（只读盘点、建议、具名执行）。已有清单沿用稳定 OWNER/REPO，不因一次授权扩展到新找到的仓库。
+
+给出可见性/分页覆盖、逐仓库建议或执行对照和未知项；权限结论绑定本次 gh 身份与具体端点，不推广到连接器或另一个 PAT。
+
+示例：“只盘点我个人 GitHub 账号的归档仓库和 star，给整理建议。”应进入本技能；“修复当前项目的 TypeScript 类型错误。”不应由本技能接管。
+
+需要当前环境可用的 gh；现有 inventory.sh 还需要 Bash。先确认实际主机、shell、gh 版本及账号。Windows 没有 Bash 时不把 .sh 当 PowerShell 运行：使用 gh 的原生只读查询，标明与完整盘点脚本的覆盖差异，不自动安装 Git Bash/WSL。
+
+技能目录从本文件定位；已有具名授权沿用，读取或整理建议不授权写入。
+
+| 任务 | 参考 |
+|---|---|
+| 盘点 | [盘点与脚本](references/01-inventory.md) |
+| star | [Stars](references/03-stars.md) |
+| 归档/删除 | [生命周期](references/02-lifecycle.md) |
+| 清理建议 | [Hygiene](references/04-hygiene.md) |
+| 认证 | [认证诊断](references/00-auth-and-tokens.md) |
+
+## 只读诊断
+
+先 gh auth status 和必要的账号字段，不打印 token。gh 与连接器/MCP 可能使用不同身份，不能互借权限结论。确认 GitHub.com 或企业 host；不把凭据发送到未经确认的主机。
+
+权限诊断禁止写探针。可读、permissions.admin 或仓库可见都不证明当前凭据能执行某一写动作。分页取全或标记部分；未见到的仓库不等于不存在。
+
+## 具名动作
+
+先确定 OWNER/REPO、动作、影响和已有授权。新增目标不继承旧清单授权。归档使用 gh repo archive 或 PATCH archived 布尔字段，gh api 用 -F 而不是字符串 -f。
+
+删除先说明影响和有条件的恢复限制，不能保证 90 天都可恢复。star/unstar 只处理已批准对象。403 停止受影响动作，报告脱敏权限提示；不切换界面绕过。token 更新后在用户授权范围内重试，不索要明文 token。
+
+不确定写入结果先只读核对，再决定是否重试。删除的 404 必须结合成功删除响应；独立 404 也可能是无权限。
+
+## 完成
+
+报告账号/host、覆盖、具名成功失败、实际状态和未知项。原生 Windows 与 POSIX 路径/引号分别验证，不能把脚本退出成功当成全量清单或写入成功。

package/skills-hub/coding/github-repo-steward/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "GitHub 仓库管家"
+  short_description: "盘点 GitHub 仓库与收藏，按具名授权整理并核对实际权限"
+  default_prompt: "请使用 $github-repo-steward：只盘点我个人 GitHub 账号的归档仓库和 star，给整理建议。"

package/skills-hub/coding/github-repo-steward/references/00-auth-and-tokens.md

@@ -0,0 +1,73 @@
+# 鉴权与 PAT
+
+权威：`gh` 当前登录态。不要假设 MCP GitHub 与 `gh` 是同一 token。
+
+## 先看什么
+
+```bash
+gh auth status
+gh api -i user | rg -i 'x-oauth|x-accepted-github-permissions|github-authentication-token-expiration'
+```
+
+| token 前缀 | 种类 |
+|---|---|
+| `github_pat_` | Fine-grained PAT |
+| `ghp_` | Classic PAT |
+| `gho_` | OAuth app |
+| `ghu_` / `ghs_` | GitHub App |
+
+Fine-grained 没有 `X-OAuth-Scopes`。缺权限时看 **403 响应头** `X-Accepted-Github-Permissions`。
+
+## 按动作选择最小权限（不是全部必选）
+
+Fine-grained PAT（https://github.com/settings/personal-access-tokens ）：
+
+| 位置 | 权限 | 级别 | 用途 |
+|---|---|---|---|
+| Repository | Metadata | Read | 列仓、读描述（通常自动带上） |
+| Repository | Contents | Read and write | clone/push；只读盘点可 Read |
+| Repository | Administration | **Read and write** | 归档、取消归档、改设置、**删除仓库** |
+| Account | **Starring** | **Read and write** | 列自己的 star 一般可读；**加/取消 star 必须 write** |
+
+Repository access 优先仅选本次具名仓库；只有明确需要账号全量覆盖且用户同意时才选择 `All repositories`。只读盘点不要同时要求归档、删除、star 的写权限。
+
+Classic PAT（https://github.com/settings/tokens ）：
+
+| scope | 用途 |
+|---|---|
+| `public_repo` 或 `repo` | 读/写公开仓；`repo` 含私有 |
+| `delete_repo` | 删除仓库（必须单独勾） |
+| 无独立 starring scope | classic 的 `public_repo`/`repo` 通常已含 star |
+
+## 改现有 token vs 新建
+
+- **改现有 Fine-grained 权限**：token 字符串不变，`gh` 不用重新 login。用户保存后直接重试。
+- **新建 token**：通过交互式 `gh auth login` 或受保护的 stdin/凭据管理器提供，不把 token 字面值拼进命令；然后，再 `gh auth status`。旧 token 不会自动换。
+- 用过期日 + 前缀辨认「当前环境到底在用哪一条」。`Github-Authentication-Token-Expiration` 响应头是可靠标识。
+
+辨认当前 token：过期时间、`github_pat_` 前缀、login。用户若改了另一条 token，这边会继续 403。
+
+## 403 诊断
+
+```
+HTTP 403
+X-Accepted-Github-Permissions: administration=write
+message: Resource not accessible by personal access token
+```
+
+把 header 里的 permission 原样翻译给用户：
+
+| header | 用户要开的项 |
+|---|---|
+| `administration=write` | Repository permissions → Administration → Read and write |
+| `starring=write,metadata=read` | Account permissions → Starring → Read and write |
+| `contents=write` | Repository permissions → Contents → Read and write |
+
+`permissions.admin: true` 出现在 GET repo JSON 里，**不代表** 这个 PAT 能归档/删除。那是「你作为用户对该仓的角色」，不是 token 能力。
+
+## 不要做的事
+
+- 不要把 token 写入 skill、仓库、issue、gist。
+- 不要用 `gh auth refresh` 去「升级」fine-grained PAT（交互式、且对 PAT 无效）。
+- 不要在 403 时改删网页上的别的仓。
+- GitHub 会自动吊销：推到公开仓/gist 的 token、一年未使用的 token。

package/skills-hub/coding/github-repo-steward/references/01-inventory.md

@@ -0,0 +1,55 @@
+# 仓库盘点
+
+## 列出自己的仓
+
+全量盘点使用技能自带脚本，GraphQL cursor 自动分页，保留当前 token 可见范围：
+
+```bash
+"$SKILL_DIR/scripts/inventory.sh"
+"$SKILL_DIR/scripts/inventory.sh" --user LOGIN
+```
+
+过滤原创、fork、已归档仓在完整结果上进行；不要把固定 `--limit 200` 的截断列表称为全量。
+`--stars` 始终列当前登录账号的星标，不随 `--user` 切换。分页中断时报部分结果，不忽略退出码。
+
+JSON 字段不够时再打 API：
+
+```bash
+gh api "repos/$ACCOUNT_LOGIN/$REPO_NAME" --jq '{open_issues_count,archived,disabled,has_pages,homepage,pushed_at}'
+gh pr list -R "$ACCOUNT_LOGIN/$REPO_NAME" --state open --json number --jq length
+gh run list -R "$ACCOUNT_LOGIN/$REPO_NAME" --limit 1 --json workflowName,status,conclusion,updatedAt
+```
+
+`open_issues_count` **包含 PR**。要「真正的 issue」用 issues 数减去 open PR 数。
+
+## 状态口径
+
+按「今天」的日历算最近推送（`pushedAt`）：
+
+| 标签 | 口径 |
+|---|---|
+| 活跃 | 近 14 天有 push，且未归档 |
+| 维护中 | 近 60 天有 push |
+| 较静默 | 近 90 天有 push |
+| 停滞 | 超过 90 天无 push |
+| 已归档 | `isArchived=true` |
+| 空仓 | `isEmpty=true` |
+| Fork | `isFork=true`，表里写上游 `parent.owner.login/parent.name` |
+
+Actions：最近一次 run 的 `conclusion`：success / failure / cancelled / 无 CI。
+
+## 输出表（给用户）
+
+自有仓：
+
+| 仓库 | 类型 | 可见性 | 状态 | 语言 | 最近推送 | Stars | Issues/PR | Actions | 说明 |
+|---|---|---|---|---|---|---|---|---|---|
+
+Star 列表另表，见 `03-stars.md`。
+
+## 只读脚本
+
+```bash
+"$SKILL_DIR/scripts/inventory.sh"
+"$SKILL_DIR/scripts/inventory.sh" --stars
+```

package/skills-hub/coding/github-repo-steward/references/02-lifecycle.md

@@ -0,0 +1,57 @@
+# 归档与删除
+
+官方文档：
+
+- 归档：https://docs.github.com/en/repositories/archiving-a-github-repository/archiving-repositories
+- 删除：https://docs.github.com/en/repositories/creating-and-managing-repositories/deleting-a-repository
+- 恢复已删仓：https://docs.github.com/en/repositories/creating-and-managing-repositories/restoring-a-deleted-repository
+
+## 归档
+
+效果：仓库变只读。Issues、PR、代码、wiki、release、权限都冻结。他人仍可 fork、star、搜索。协作者不能再被添加或移除。
+
+```bash
+gh repo archive OWNER/REPO --yes
+# 等价
+gh api -X PATCH repos/OWNER/REPO -F archived=true --jq '{name,archived}'
+```
+
+取消归档：
+
+```bash
+gh api -X PATCH repos/OWNER/REPO -F archived=false --jq '{name,archived}'
+```
+
+网页：`https://github.com/OWNER/REPO/settings` → Danger Zone → Archive。
+
+适合：自己的原创仓、还有 star/历史价值、暂时不维护。不适合：确定要灭迹的实验 fork（走删除）。
+
+## 删除
+
+```bash
+gh repo delete OWNER/REPO --yes
+```
+
+网页：Settings → Danger Zone → Delete this repository，输入仓名确认。
+
+后果：
+
+- 公有仓的 fork **不会**随删除消失。
+- 私有仓的 fork **会**一起删。
+- 团队权限永久丢掉。
+- 部分仓库可在删除后 90 天内恢复；非空 fork 网络等情况存在限制，GitHub Support 恢复支持还受付费计划条件限制。不能承诺一定可恢复。
+- 同名 `OWNER/REPO` 可能被保留一段时间不能新建；若删前一周 Actions 用量或 clone 很高，名称组合可能被永久退役。
+
+复核：先确认本次删除返回成功，再以同一账号读取应为 404；单独的 404 也可能表示不可见，不能作为删除成功的唯一证据。
+
+适合：已被新仓替代的旧 fork、空仓、明确废弃的镜像。有 star 的原创仓默认归档。
+
+## 选择
+
+| 情况 | 动作 |
+|---|---|
+| 原创、有 star 或有文档价值、不再开发 | 归档 |
+| 上游已迁走的 fork / 配套 docs | 删除 |
+| 空仓、错 fork、一次性实验 | 删除 |
+| 还在用 | 不动 |
+| 不确定 | 只列入 hygiene 建议，等用户点名 |

package/skills-hub/coding/github-repo-steward/references/03-stars.md

@@ -0,0 +1,42 @@
+# Star 列表与批量取消
+
+Star 是**账号级**操作。Fine-grained PAT 要开 **Account permissions → Starring → Read and write**。只开了仓库 Administration 不能 unstar。
+
+## 列出
+
+```bash
+gh api --paginate -H "Accept: application/vnd.github.star+json" user/starred \
+  --jq '.[] | [
+      .starred_at,
+      .repo.full_name,
+      (.repo.stargazers_count|tostring),
+      (.repo.language // "-"),
+      (if .repo.archived then "archived" else "active" end),
+      (if .repo.fork then "fork" else "orig" end),
+      (.repo.description // "")
+    ] | @tsv'
+```
+
+给用户时按主题分组，每条一句话说明。标出 `OWNER == 当前 login` 的自有仓。
+
+## 查询单个
+
+```bash
+gh api -X GET user/starred/OWNER/REPO
+# 204 = 已 star；404 = 未 star
+```
+
+## 加 / 取消
+
+```bash
+gh api -X PUT    user/starred/OWNER/REPO    # star → 204
+gh api -X DELETE user/starred/OWNER/REPO    # unstar → 204；本来没 star → 404
+```
+
+用户给一批仓时：逐个调用，汇总 `ok / already_not_starred / fail`。任一 403 立刻停，报告 `X-Accepted-Github-Permissions`（通常是 `starring=write,metadata=read`）。
+
+不要把 403 报成已取消。用 GET 复核。
+
+## MCP
+
+`github__unstar_repository` / `github__star_repository` 走的是 GitHub App/MCP 凭证，可能和 `gh` 不是同一权限集。一边 403 时试另一边；两边都 403 就让用户改 PAT 或 MCP 安装权限。

package/skills-hub/coding/github-repo-steward/references/04-hygiene.md

@@ -0,0 +1,40 @@
+# 仓库卫生方法
+
+先盘点，再出**建议清单**，等用户点具名仓。不要自行扩大范围。
+
+## 建议规则
+
+1. **原创 + 近 60 天有 push** → 保留。
+2. **原创 + 长期无 push + 有 star 或有文档** → 建议归档，不删。
+3. **Fork，且自己已用新仓替代**（例如旧 RuoYi fork 已迁到自己的 monorepo）→ 建议删除。
+4. **Fork，仅作上游跟踪、自己无独特提交** → 问用户：留着同步 / 删除。
+5. **空仓、错 fork、一次性实验** → 建议删除。
+6. **已归档** → 除非用户要灭迹，否则不动。
+7. **CI 失败** 只报告，不当作删除理由。
+8. **开放 PR 很多** 只报告积压，不当作删除理由。
+
+## 建议清单格式
+
+```
+归档（可逆）
+- OWNER/REPO — 原因
+
+删除（不可逆）
+- OWNER/REPO — 原因
+
+保留
+- OWNER/REPO — 原因
+
+取消 star（与自有仓无关）
+- OWNER/REPO — 原因
+```
+
+用户回复「按这份做」或点名子集后，再进入 archive / delete / stars-mutate。
+
+## 执行顺序
+
+1. 归档（失败也不影响删除）
+2. 删除
+3. unstar（独立权限，可单独做）
+4. 逐项 API 复核
+5. 再跑一次 `gh repo list` / star 列表，把新状态表给用户

package/skills-hub/coding/github-repo-steward/references/05-sources.md

@@ -0,0 +1,42 @@
+# 来源
+
+本技能吸收官方文档、gh CLI、以及现有 GitHub 向 agent skill。那些 skill 偏 issue/PR/workflow；本技能偏**账号仓库生命周期**。
+
+## GitHub 官方
+
+- 归档：https://docs.github.com/en/repositories/archiving-a-github-repository/archiving-repositories
+- 删除：https://docs.github.com/en/repositories/creating-and-managing-repositories/deleting-a-repository
+- 恢复已删仓：https://docs.github.com/en/repositories/creating-and-managing-repositories/restoring-a-deleted-repository
+- PAT：https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
+- Fine-grained 权限与 REST 对照：https://docs.github.com/en/rest/authentication/permissions-required-for-fine-grained-personal-access-tokens
+- Token 过期与吊销：https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/token-expiration-and-revocation
+- 凭证类型：https://docs.github.com/en/organizations/managing-programmatic-access-to-your-organization/github-credential-types
+- Star REST：https://docs.github.com/en/rest/activity/starring
+
+设置页：
+
+- Fine-grained PAT：https://github.com/settings/personal-access-tokens
+- 新建 Fine-grained：https://github.com/settings/personal-access-tokens/new
+- Classic PAT：https://github.com/settings/tokens
+
+## gh CLI
+
+- 手册：https://cli.github.com/manual/
+- `gh repo archive` / `gh repo delete` / `gh repo list`
+- `gh api`、`gh api graphql`
+- `gh skill`（安装/发布 agent skills，不是管仓库卫生）：https://github.blog/changelog/2026-04-16-manage-agent-skills-with-github-cli/
+
+## 同类 skill（参考，不替代本技能）
+
+- `shalomb/agent-skills` → `skills/github-cli`：通用 gh，强调 **不要猜 flag**，复杂操先读 reference。偏 issue/PR/Actions/GraphQL。
+- `odyssey4me/agent-skills` → `skills/github`：`gh` + 只读 Python 包装；写操作直接 `gh`。偏 issue/PR/workflow。
+- Agent Skills 规范：https://agentskills.io/specification
+- `gh skill` 跨 Copilot / Claude Code / Cursor / Codex 安装：GitHub CLI v2.90+
+
+## 方法要点（从官方 + 实操）
+
+- 规划与执行分开（破坏性清单必须用户点名）。
+- Fine-grained：归档/删除 = Repository **Administration=write**；star = Account **Starring=write**。二者独立。
+- 403 以 `X-Accepted-Github-Permissions` 为准，不以 GET repo 的 `permissions.admin` 为准。
+- 改同一条 PAT 的权限后无需重新 `gh auth login`；新建 PAT 必须换 token。
+- 删除公有仓不删别人的 fork；约 90 天可申请恢复。

package/skills-hub/coding/github-repo-steward/scripts/inventory.sh

@@ -0,0 +1,64 @@
+#!/usr/bin/env bash
+# Read-only inventory of the authenticated GitHub user's repos and optional stars.
+set -euo pipefail
+
+usage() {
+  echo "usage: inventory.sh [--stars] [--user LOGIN]" >&2
+  exit 2
+}
+
+STARS=0
+ACCOUNT_LOGIN=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --stars) STARS=1; shift ;;
+    --user) [[ $# -ge 2 && -n "$2" && "$2" != -* ]] || usage; ACCOUNT_LOGIN="$2"; shift 2 ;;
+    -h|--help) usage ;;
+    *) usage ;;
+  esac
+done
+
+if [[ -z "$ACCOUNT_LOGIN" ]]; then
+  ACCOUNT_LOGIN=$(gh api user --jq .login)
+fi
+
+echo "# owner=$ACCOUNT_LOGIN"
+echo "# repos"
+printf '%s\n' "name	visibility	archived	fork	empty	pushed	stars	lang	url	description"
+gh api graphql --paginate -f login="$ACCOUNT_LOGIN" -f query='
+  query($login: String!, $endCursor: String) {
+    repositoryOwner(login: $login) {
+      repositories(first: 100, after: $endCursor, ownerAffiliations: OWNER) {
+        nodes { name visibility isArchived isFork isEmpty pushedAt stargazerCount primaryLanguage { name } url description }
+        pageInfo { hasNextPage endCursor }
+      }
+    }
+  }' \
+  --jq '.data.repositoryOwner.repositories.nodes[] | [
+      .name,
+      .visibility,
+      (if .isArchived then "archived" else "active" end),
+      (if .isFork then "fork" else "orig" end),
+      (if .isEmpty then "empty" else "has-code" end),
+      (.pushedAt // "-"),
+      (.stargazerCount|tostring),
+      ((.primaryLanguage.name) // "-"),
+      .url,
+      ((.description // "") | gsub("\t";" ") | gsub("\n";" "))
+    ] | @tsv'
+
+if [[ "$STARS" -eq 1 ]]; then
+  echo
+  echo "# stars"
+  printf '%s\n' "starred_at	full_name	stars	lang	archived	fork	description"
+  gh api --paginate -H "Accept: application/vnd.github.star+json" user/starred \
+    --jq '.[] | [
+        .starred_at,
+        .repo.full_name,
+        (.repo.stargazers_count|tostring),
+        (.repo.language // "-"),
+        (if .repo.archived then "archived" else "active" end),
+        (if .repo.fork then "fork" else "orig" end),
+        ((.repo.description // "") | gsub("\t";" ") | gsub("\n";" "))
+      ] | @tsv'
+fi

package/skills-hub/coding/vscode-fullstack/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ting'an Wang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills-hub/coding/vscode-fullstack/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: vscode-fullstack
+description: 整理 VS Code 本机与 Remote SSH/WSL/Container 的 Profile、扩展和 JSONC 设置，复用已有 Java/Maven、Go、Node、Python 与 Vue/React 开发环境。用于工具找不到、重复下载或本地远程配置不一致；保留项目版本与用户定制，不接管应用开发或系统运行时安装。
+license: MIT
+compatibility: Requires access to the actual VS Code/Insiders/Remote host and its supported CLI or UI; extension installation needs approved network access.
+metadata:
+  author: NAMEWTA
+  wta-format-reviewed: '2026-10-14'
+---
+# VS Code 全栈 Profile
+
+## 输入与输出契约
+
+先确定实际可访问的机器、产品、活动 Profile、扩展主机、所需语言和只读/修改模式。仅配置一个 Profile 时不扩大到全部；用户要求整体统一时，盘点相关 Profile，选主用基线并保留旧项和项目特例，不把“整理”解释成批量删除。
+
+沿用本次会话已确认的目标和授权，不重复询问已决定的事项。仅对影响结果而无法推断的选择补问，例如主用 Profile 或是否改变项目的 Wrapper 策略；等待期间继续只读盘点。未使用的语言不整套安装。
+
+交付主机/Profile/设置作用域清单、实际变更及保留冲突、工具入口与版本、备份/回滚方法和逐层验收结果。无法访问的客户端给出具体步骤和待验收项，不宣称已配置成功。
+
+“Ubuntu 本地和 Windows Remote SSH 都使用现有 Java、Go、Node”或“给当前 Profile 补 Python/Vue，保留 formatter”应进入本技能；“给 React 页面添加登录表单”不应进入。
+
+## 先盘点，再形成差异
+
+1. 确认 Stable/Insiders/便携版、系统/架构、实际 CLI 和 Server 版本；用 `--version`、`--help` 及活动窗口验证能力。区分客户端与执行代码的主机，不将容器当用户电脑，不因两个目录的 Profile 同名就认定已同步。
+2. 读取目标设置、工作区覆盖、扩展 ID/版本/启用状态及已有项目版本选择机制。多端统一或调整默认 Profile 时先读 [Profile、作用域与验收](references/profiles-and-validation.md)。
+3. 涉及已有工具发现、重复下载或项目版本时，读 [运行时复用](references/runtime-reuse.md)，比较 shell、扩展宿主、集成终端和调试器实际入口，不能只凭路径存在判断可用。
+4. 按 [扩展与设置](references/extensions-and-settings.md) 选择缺失能力，列出每项新增/修改/删除、目标作用域和理由；用户的 formatter、解释器、片段和禁用选择优先。
+
+扩展、工具下载及联网文档核对须在宿主允许及用户任务授权范围内；说明目标服务可见的请求信息，不上传配置、凭据或项目内容。离线任务使用本地清单和已核验缓存，缺少能力时明确报告。
+
+## 备份后最小修改
+
+使用每轮独立的私有备份目录，记录原文件内容、原先不存在、权限、摘要，以及扩展版本/启用状态、Profile 和工作区关联。先预览差异；写前比较基线，发现并发编辑先重新合并。具体回滚边界见 [备份与回滚](references/profiles-and-validation.md#备份与回滚)。
+
+`settings.json` 按 JSONC 处理：用可靠解析器的增量编辑或精确补丁加解析校验，保留注释、尾逗号和无关键，拒绝无效输入，不自制正则解析器或严格 JSON 整文件重排。对象按键合并；仅对集合型数组去重合并，保留 PATH 等有序配置的语义。已有冲突默认保留并报告；明确属于用户授权的统一目标时才定向修正。
+
+通过受支持的 CLI/UI 创建、选择、关联 Profile 和安装扩展。不得手写内部数据库、扩展注册表或复制/共享扩展目录模拟安装。安装前检查扩展包成员和必要依赖，安装后重新比对清单；锁定扩展包版本不等于锁定依赖。
+
+复用现有语言运行时与项目选择入口；必要的缺失辅助工具（如 gopls、Delve）按兼容性和已授权下载范围补齐，不隐式升级语言运行时。不重写项目规范或系统全局环境，不为通过测试关闭 Workspace Trust、TLS 或签名验证。
+
+目标不明、权限拒绝、配置损坏、版本不兼容或来源无法验证时停止相关写入，保留可完成的独立工作及具体阻碍；安装失败按有限次数重试，只终止本任务启动的进程树。没有新证据不反复重装、清缓存或扩大权限。
+
+## 验收
+
+按改动范围逐层检查：配置读回及重复执行无差异 → 运行时版本/最小样例 → 实际扩展宿主的补全、诊断、格式化或调试 → 各客户端连接。完整环境统一按 [验收分层](references/profiles-and-validation.md#验收分层) 执行；小范围设置变更只运行相关检查。
+
+报告明确区分静态读回、命令行运行、隔离编辑器验证、真实业务项目与真实 Remote 会话。旧日志、目录里存在扩展、设置写入或 Settings Sync 成功都不能代替激活与功能证据。保留失败与复测记录；缺少 GUI/客户端时标为待验证。

package/skills-hub/coding/vscode-fullstack/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "VS Code 全栈环境"
+  short_description: "统一本机与远程 VS Code，复用已有运行时并保留 Profile 定制"
+  default_prompt: "请使用 $vscode-fullstack：统一本机与 Remote SSH 的开发环境，复用已有 Java/Maven、Go、Node，保留项目版本和 formatter。"