refactor(plugin 命名空間): plugin 更名 jsc-code、skill 去領域前綴 #16
@@ -2,7 +2,7 @@
|
|||||||
"name": "code",
|
"name": "code",
|
||||||
"plugins": [
|
"plugins": [
|
||||||
{
|
{
|
||||||
"name": "jsc",
|
"name": "jsc-code",
|
||||||
"source": {
|
"source": {
|
||||||
"source": "url",
|
"source": "url",
|
||||||
"url": "https://gitea.jsc.idv.tw/plugins/code.git"
|
"url": "https://gitea.jsc.idv.tw/plugins/code.git"
|
||||||
|
|||||||
@@ -6,7 +6,7 @@
|
|||||||
},
|
},
|
||||||
"plugins": [
|
"plugins": [
|
||||||
{
|
{
|
||||||
"name": "jsc",
|
"name": "jsc-code",
|
||||||
"source": "./",
|
"source": "./",
|
||||||
"description": "JSC 程式碼工作流 skills：Gitea AI review findings 修復與 PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步、action / Dockerfile 標準化。"
|
"description": "JSC 程式碼工作流 skills：Gitea AI review findings 修復與 PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步、action / Dockerfile 標準化。"
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "jsc",
|
"name": "jsc-code",
|
||||||
"version": "0.1.0",
|
"version": "0.0.1",
|
||||||
"description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc: 前綴呼叫。",
|
"description": "JSC 程式碼工作流 plugin（Claude Code / Codex / Antigravity / OpenCode），提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Claude Code 以 /jsc-code: 前綴呼叫。",
|
||||||
"skills": "./skills",
|
"skills": "./skills",
|
||||||
"author": {
|
"author": {
|
||||||
"name": "JSC"
|
"name": "JSC"
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "jsc",
|
"name": "jsc-code",
|
||||||
"version": "0.1.0",
|
"version": "0.0.1",
|
||||||
"description": "JSC 程式碼工作流 plugin，提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。",
|
"description": "JSC 程式碼工作流 plugin，提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程。",
|
||||||
"skills": "./skills"
|
"skills": "./skills"
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
# jsc — 共用 Skills（跨 AI 助理）
|
# jsc-code — 共用 Skills（跨 AI 助理）
|
||||||
|
|
||||||
本 repo 是一組以 **Agent Skills（`SKILL.md`）** 標準撰寫的共用 skills，可同時被 Claude Code、Codex、Antigravity、OpenCode 使用。
|
本 repo 是一組以 **Agent Skills（`SKILL.md`）** 標準撰寫的共用 skills，可同時被 Claude Code、Codex、Antigravity、OpenCode 使用。
|
||||||
|
|
||||||
@@ -6,7 +6,7 @@
|
|||||||
|
|
||||||
- 所有可用的 skills 位於本 repo 的 `skills/<name>/SKILL.md`。
|
- 所有可用的 skills 位於本 repo 的 `skills/<name>/SKILL.md`。
|
||||||
- 在處理任務前，先比對使用者需求與各 skill `SKILL.md` frontmatter 的 `description`，若相符請載入並依其步驟執行。
|
- 在處理任務前，先比對使用者需求與各 skill `SKILL.md` frontmatter 的 `description`，若相符請載入並依其步驟執行。
|
||||||
- **呼叫慣例**：在 Claude Code 與 Antigravity 中，這些 skill 以 `/jsc:<name>` 呼叫；Codex 以 `$<name>`、OpenCode 由模型依描述自動觸發 — 兩者沒有 `/jsc:` 前綴，不需強制加。
|
- **呼叫慣例**：在 Claude Code 與 Antigravity 中，這些 skill 以 `/jsc-code:<name>` 呼叫；Codex 以 `$<name>`、OpenCode 由模型依描述自動觸發 — 兩者沒有 `/jsc-code:` 前綴，不需強制加。
|
||||||
- 完整清單與每個 skill 的用途，請見 `README.md` 的「Skills 目錄」。
|
- 完整清單與每個 skill 的用途，請見 `README.md` 的「Skills 目錄」。
|
||||||
|
|
||||||
## 慣例
|
## 慣例
|
||||||
|
|||||||
@@ -1,22 +1,22 @@
|
|||||||
# jsc — 跨 AI 助理程式碼工作流 Plugin
|
# jsc-code — 跨 AI 助理程式碼工作流 Plugin
|
||||||
|
|
||||||
一個可同時被 **Claude Code、Codex、Antigravity、OpenCode、GitHub Copilot** 使用的 plugin，提供一組以 **程式碼工作流** 為核心的 skills：
|
一個可同時被 **Claude Code、Codex、Antigravity、OpenCode、GitHub Copilot** 使用的 plugin，提供一組以 **程式碼工作流** 為核心的 skills：
|
||||||
**Gitea AI review findings 修復、分類提交、push 與 PR 建立流程**、**Gitea 議題 TODO 彙整與逐項實作流程**、**C# / .NET NuGet 套件更新流程**、**Gitea 專案批次同步**，以及 **action / Dockerfile 標準化流程**。
|
**Gitea AI review findings 修復、分類提交、push 與 PR 建立流程**、**Gitea 議題 TODO 彙整與逐項實作流程**、**C# / .NET NuGet 套件更新流程**、**Gitea 專案批次同步**，以及 **action / Dockerfile 標準化流程**。
|
||||||
核心是以 [Agent Skills（`SKILL.md`）](https://agentskills.io) 標準撰寫的共用 skills（唯一真實來源放在 `skills/`），
|
核心是以 [Agent Skills（`SKILL.md`）](https://agentskills.io) 標準撰寫的共用 skills（唯一真實來源放在 `skills/`），
|
||||||
搭配各助理各自的 plugin manifest，讓**同一個 repo** 可用各家**原生 plugin CLI** 安裝。
|
搭配各助理各自的 plugin manifest，讓**同一個 repo** 可用各家**原生 plugin CLI** 安裝。
|
||||||
plugin 名為 `jsc`，在 Claude Code 與 Antigravity 中 skill 以 **`/jsc:` 前綴**呼叫（例如 `/jsc:code-issues`）。
|
plugin 名為 `jsc-code`，在 Claude Code 與 Antigravity 中 skill 以 **`/jsc-code:` 前綴**呼叫（例如 `/jsc-code:issues`）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 前綴與呼叫方式
|
## 前綴與呼叫方式
|
||||||
|
|
||||||
| 助理 | 安裝方式 | 呼叫 | `/jsc:` 前綴 |
|
| 助理 | 安裝方式 | 呼叫 | `/jsc-code:` 前綴 |
|
||||||
| --- | --- | --- | --- |
|
| --- | --- | --- | --- |
|
||||||
| Claude Code | `claude plugin`（marketplace） | `/jsc:<name>` 或自動觸發 | ✅ |
|
| Claude Code | `claude plugin`（marketplace） | `/jsc-code:<name>` 或自動觸發 | ✅ |
|
||||||
| Codex | `codex plugin`（marketplace） | `$<name>` 或 `/skills` 選單 | ❌（用 `$name`） |
|
| Codex | `codex plugin`（marketplace） | `$<name>` 或 `/skills` 選單 | ❌（用 `$name`） |
|
||||||
| Antigravity | `agy plugin install` | `/jsc:<name>` 或自動觸發 | ✅ |
|
| Antigravity | `agy plugin install` | `/jsc-code:<name>` 或自動觸發 | ✅ |
|
||||||
| OpenCode | skills 目錄（複製/clone） | 描述需求自動觸發 | ❌（依名稱） |
|
| OpenCode | skills 目錄（複製/clone） | 描述需求自動觸發 | ❌（依名稱） |
|
||||||
| GitHub Copilot CLI | `copilot plugin`（marketplace） | 自然語言或 plugin skills | ❌（無 `/jsc:` 前綴） |
|
| GitHub Copilot CLI | `copilot plugin`（marketplace） | 自然語言或 plugin skills | ❌（無 `/jsc-code:` 前綴） |
|
||||||
|
|
||||||
> Codex 不支援自訂前綴（skill 以 `$name` 呼叫）；OpenCode 由模型依描述自動呼叫；Copilot CLI 透過原生 plugin 安裝後以自然語言或 plugin skills 使用。三者皆**不強制**前綴。
|
> Codex 不支援自訂前綴（skill 以 `$name` 呼叫）；OpenCode 由模型依描述自動呼叫；Copilot CLI 透過原生 plugin 安裝後以自然語言或 plugin skills 使用。三者皆**不強制**前綴。
|
||||||
|
|
||||||
@@ -29,22 +29,22 @@ plugin 名為 `jsc`，在 Claude Code 與 Antigravity 中 skill 以 **`/jsc:`
|
|||||||
```
|
```
|
||||||
code/
|
code/
|
||||||
├── .claude-plugin/
|
├── .claude-plugin/
|
||||||
│ ├── plugin.json # Claude 外掛定義（name: "jsc"）
|
│ ├── plugin.json # Claude 外掛定義（name: "jsc-code"）
|
||||||
│ └── marketplace.json # Claude marketplace（name: "code"，source 指向本 repo）
|
│ └── marketplace.json # Claude marketplace（name: "code"，source 指向本 repo）
|
||||||
├── .codex-plugin/
|
├── .codex-plugin/
|
||||||
│ └── plugin.json # Codex 外掛定義（name: "jsc"，skills: "./skills"）
|
│ └── plugin.json # Codex 外掛定義（name: "jsc-code"，skills: "./skills"）
|
||||||
├── .agents/plugins/
|
├── .agents/plugins/
|
||||||
│ └── marketplace.json # Codex marketplace（name: "code"，url source 指向本 repo）
|
│ └── marketplace.json # Codex marketplace（name: "code"，url source 指向本 repo）
|
||||||
├── plugin.json # Antigravity 外掛定義（name: "jsc"，skills: "./skills/"）
|
├── plugin.json # Antigravity 外掛定義（name: "jsc-code"，skills: "./skills/"）
|
||||||
├── skills/ # ★ 唯一真實來源：所有 skills
|
├── skills/ # ★ 唯一真實來源：所有 skills
|
||||||
│ ├── code-review-resolve/ # 解決 findings.json + 分類提交 + push + 發 PR
|
│ ├── review-resolve/ # 解決 findings.json + 分類提交 + push + 發 PR
|
||||||
│ ├── code-issues/ # 彙整議題 TODO（影響範圍小→大）+ 逐項實作 + 留言進度
|
│ ├── issues/ # 彙整議題 TODO（影響範圍小→大）+ 逐項實作 + 留言進度
|
||||||
│ ├── code-nuget/ # C# / .NET NuGet 套件更新 + build 驗證
|
│ ├── nuget/ # C# / .NET NuGet 套件更新 + build 驗證
|
||||||
│ ├── code-sync/ # 依擁有者批次 clone／更新 Gitea 專案
|
│ ├── sync/ # 依擁有者批次 clone／更新 Gitea 專案
|
||||||
│ ├── code-action-docker/ # action 容器化（Node 主程式）+ 串接 doc-funcs
|
│ ├── action-docker/ # action 容器化（Node 主程式）+ 串接 funcs
|
||||||
│ ├── code-action-composite/ # composite action 標準化 + 串接 doc-funcs
|
│ ├── action-composite/ # composite action 標準化 + 串接 funcs
|
||||||
│ ├── code-action-node/ # Node（JS）action 標準化（ncc 打包）+ 串接 doc-funcs
|
│ ├── action-node/ # Node（JS）action 標準化（ncc 打包）+ 串接 funcs
|
||||||
│ └── code-image/ # Dockerfile 整理成六步流程 + 串接 doc-funcs
|
│ └── image/ # Dockerfile 整理成六步流程 + 串接 funcs
|
||||||
├── AGENTS.md # 跨助理共用指引
|
├── AGENTS.md # 跨助理共用指引
|
||||||
└── README.md
|
└── README.md
|
||||||
```
|
```
|
||||||
@@ -64,39 +64,39 @@ code/
|
|||||||
```bash
|
```bash
|
||||||
# 安裝
|
# 安裝
|
||||||
claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/code.git
|
claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/code.git
|
||||||
claude plugin install jsc@code
|
claude plugin install jsc-code@code
|
||||||
|
|
||||||
# 更新
|
# 更新
|
||||||
claude plugin marketplace update code
|
claude plugin marketplace update code
|
||||||
claude plugin update jsc@code
|
claude plugin update jsc-code@code
|
||||||
|
|
||||||
# 移除
|
# 移除
|
||||||
claude plugin uninstall jsc@code
|
claude plugin uninstall jsc-code@code
|
||||||
claude plugin marketplace remove code
|
claude plugin marketplace remove code
|
||||||
```
|
```
|
||||||
|
|
||||||
- 工作階段內 slash 版（等價）：把 `claude plugin` 換成 `/plugin`。
|
- 工作階段內 slash 版（等價）：把 `claude plugin` 換成 `/plugin`。
|
||||||
- 本機開發（免 push）：`claude plugin marketplace add C:\Users\h3285\source\repos.plugins\code`（本地路徑）後再 install。
|
- 本機開發（免 push）：`claude plugin marketplace add C:\Users\h3285\source\repos.plugins\code`（本地路徑）後再 install。
|
||||||
- **呼叫**：`/jsc:<name>`（例 `/jsc:code-issues`）。
|
- **呼叫**：`/jsc-code:<name>`（例 `/jsc-code:issues`）。
|
||||||
|
|
||||||
### Codex
|
### Codex
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 安裝
|
# 安裝
|
||||||
codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/code.git
|
codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/code.git
|
||||||
codex plugin add jsc@code
|
codex plugin add jsc-code@code
|
||||||
|
|
||||||
# 更新（重新抓取 marketplace 的 git 快照）
|
# 更新（重新抓取 marketplace 的 git 快照）
|
||||||
codex plugin marketplace upgrade code
|
codex plugin marketplace upgrade code
|
||||||
|
|
||||||
# 移除
|
# 移除
|
||||||
codex plugin remove jsc@code
|
codex plugin remove jsc-code@code
|
||||||
codex plugin marketplace remove code
|
codex plugin marketplace remove code
|
||||||
```
|
```
|
||||||
|
|
||||||
- 安裝 token `jsc@code` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。
|
- 安裝 token `jsc-code@code` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。
|
||||||
- 本 repo 的 Codex marketplace 以 `url` 來源指向自己，故 Codex **一律從 gitea 安裝**（需先 push）；安裝後重啟 Codex。
|
- 本 repo 的 Codex marketplace 以 `url` 來源指向自己，故 Codex **一律從 gitea 安裝**（需先 push）；安裝後重啟 Codex。
|
||||||
- **呼叫**：`$<name>`（例 `$code-issues`），或用 `/skills` 選單。
|
- **呼叫**：`$<name>`（例 `$issues`），或用 `/skills` 選單。
|
||||||
|
|
||||||
### Antigravity（`agy`）
|
### Antigravity（`agy`）
|
||||||
|
|
||||||
@@ -109,16 +109,16 @@ agy plugin install ~/plugins/code
|
|||||||
|
|
||||||
# 更新（agy 無 update 子指令 → git pull 後重裝）
|
# 更新（agy 無 update 子指令 → git pull 後重裝）
|
||||||
git -C ~/plugins/code pull
|
git -C ~/plugins/code pull
|
||||||
agy plugin uninstall jsc
|
agy plugin uninstall jsc-code
|
||||||
agy plugin install ~/plugins/code
|
agy plugin install ~/plugins/code
|
||||||
|
|
||||||
# 移除
|
# 移除
|
||||||
agy plugin uninstall jsc
|
agy plugin uninstall jsc-code
|
||||||
```
|
```
|
||||||
|
|
||||||
- 若把 skills 放到 GitHub，則可直接 `agy plugin install https://github.com/<owner>/<repo>`。
|
- 若把 skills 放到 GitHub，則可直接 `agy plugin install https://github.com/<owner>/<repo>`。
|
||||||
- 其他：`agy plugin list`、`agy plugin enable jsc` / `disable jsc`、`agy plugin validate <path>`。安裝後重啟工作階段。
|
- 其他：`agy plugin list`、`agy plugin enable jsc-code` / `disable jsc-code`、`agy plugin validate <path>`。安裝後重啟工作階段。
|
||||||
- **呼叫**：`/jsc:<name>`（例 `/jsc:code-issues`）或依描述自動觸發。
|
- **呼叫**：`/jsc-code:<name>`（例 `/jsc-code:issues`）或依描述自動觸發。
|
||||||
|
|
||||||
### OpenCode
|
### OpenCode
|
||||||
|
|
||||||
@@ -136,7 +136,7 @@ git -C ~/jsc-plugin pull
|
|||||||
cp -r ~/jsc-plugin/skills/* ~/.config/opencode/skills/
|
cp -r ~/jsc-plugin/skills/* ~/.config/opencode/skills/
|
||||||
|
|
||||||
# 移除
|
# 移除
|
||||||
rm -rf ~/.config/opencode/skills/{code-review-resolve,code-issues,code-nuget,code-sync,code-action-docker,code-action-composite,code-action-node,code-image}
|
rm -rf ~/.config/opencode/skills/{review-resolve,issues,nuget,sync,action-docker,action-composite,action-node,image}
|
||||||
```
|
```
|
||||||
|
|
||||||
> **Windows PowerShell**：`cp -r A B` → `Copy-Item A B -Recurse -Force`、`rm -rf X` → `Remove-Item X -Recurse -Force`、`~` → `$HOME`。
|
> **Windows PowerShell**：`cp -r A B` → `Copy-Item A B -Recurse -Force`、`rm -rf X` → `Remove-Item X -Recurse -Force`、`~` → `$HOME`。
|
||||||
@@ -150,20 +150,20 @@ Copilot CLI 支援與 Claude Code 類似的原生 plugin / marketplace 指令，
|
|||||||
```bash
|
```bash
|
||||||
# 安裝
|
# 安裝
|
||||||
copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/code.git
|
copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/code.git
|
||||||
copilot plugin install jsc@code
|
copilot plugin install jsc-code@code
|
||||||
|
|
||||||
# 更新
|
# 更新
|
||||||
copilot plugin marketplace update code
|
copilot plugin marketplace update code
|
||||||
copilot plugin update jsc@code
|
copilot plugin update jsc-code@code
|
||||||
|
|
||||||
# 移除
|
# 移除
|
||||||
copilot plugin uninstall jsc@code
|
copilot plugin uninstall jsc-code@code
|
||||||
copilot plugin marketplace remove code
|
copilot plugin marketplace remove code
|
||||||
```
|
```
|
||||||
|
|
||||||
- 安裝 token `jsc@code` = plugin 名（plugin manifest 的 `name`）@ marketplace 名。
|
- 安裝 token `jsc-code@code` = plugin 名（plugin manifest 的 `name`）@ marketplace 名。
|
||||||
- `copilot plugin marketplace add` 支援 GitHub `owner/repo`、git URL 與本地路徑；Gitea repo 可用上方 HTTPS URL。
|
- `copilot plugin marketplace add` 支援 GitHub `owner/repo`、git URL 與本地路徑；Gitea repo 可用上方 HTTPS URL。
|
||||||
- **呼叫**：在 Copilot CLI 中用自然語言描述需求，例如 `copilot -i "請使用 code-issues 處理 plugins/code 的 12、15 號議題"`。
|
- **呼叫**：在 Copilot CLI 中用自然語言描述需求，例如 `copilot -i "請使用 issues 處理 plugins/code 的 12、15 號議題"`。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -171,18 +171,18 @@ copilot plugin marketplace remove code
|
|||||||
|
|
||||||
安裝好之後，不必進互動介面，一行指令就能叫某個 skill 跑完並印出結果：
|
安裝好之後，不必進互動介面，一行指令就能叫某個 skill 跑完並印出結果：
|
||||||
|
|
||||||
| 助理 | headless 指令 | 執行 `code-issues` skill |
|
| 助理 | headless 指令 | 執行 `issues` skill |
|
||||||
| --- | --- | --- |
|
| --- | --- | --- |
|
||||||
| Claude Code | `claude -p "<prompt>"` | `claude -p "/jsc:code-issues --tool api --repo plugins/code --issues 12,15 --yes"` |
|
| Claude Code | `claude -p "<prompt>"` | `claude -p "/jsc-code:issues --tool api --repo plugins/code --issues 12,15 --yes"` |
|
||||||
| Codex | `codex exec "<prompt>"` | `codex exec '$code-issues --tool api --repo plugins/code --issues 12,15 --yes'` |
|
| Codex | `codex exec "<prompt>"` | `codex exec '$issues --tool api --repo plugins/code --issues 12,15 --yes'` |
|
||||||
| Antigravity | `agy -p "<prompt>"` | `agy -p "/jsc:code-issues --tool api --repo plugins/code --issues 12,15 --yes"` |
|
| Antigravity | `agy -p "<prompt>"` | `agy -p "/jsc-code:issues --tool api --repo plugins/code --issues 12,15 --yes"` |
|
||||||
| OpenCode | `opencode run "<message>"` | `opencode run "讀 plugins/code 的 12、15 號議題，整理 TODO 並逐項實作、留言進度"` |
|
| OpenCode | `opencode run "<message>"` | `opencode run "讀 plugins/code 的 12、15 號議題，整理 TODO 並逐項實作、留言進度"` |
|
||||||
| GitHub Copilot CLI | `copilot -p "<message>"` | `copilot -p "讀 plugins/code 的 12、15 號議題，整理 TODO 並逐項實作、留言進度"` |
|
| GitHub Copilot CLI | `copilot -p "<message>"` | `copilot -p "讀 plugins/code 的 12、15 號議題，整理 TODO 並逐項實作、留言進度"` |
|
||||||
|
|
||||||
- Claude / Antigravity 支援 `/jsc:` 前綴，直接 `-p "/jsc:<name>"` 即可。
|
- Claude / Antigravity 支援 `/jsc-code:` 前綴，直接 `-p "/jsc-code:<name>"` 即可。
|
||||||
- Codex 以 `$<name>` 觸發；在 shell 請用**單引號**避免 `$` 被展開：`codex exec '$code-issues …'`。
|
- Codex 以 `$<name>` 觸發；在 shell 請用**單引號**避免 `$` 被展開：`codex exec '$issues …'`。
|
||||||
- OpenCode 與 Copilot 沒有前綴，用自然語言描述需求；Copilot CLI 會讀取已安裝 plugin 提供的 skills。
|
- OpenCode 與 Copilot 沒有前綴，用自然語言描述需求；Copilot CLI 會讀取已安裝 plugin 提供的 skills。
|
||||||
- 帶引數就接在後面，例如 `claude -p "/jsc:code-issues --issues 12"`、`codex exec '$code-issues --issues 12'`。
|
- 帶引數就接在後面，例如 `claude -p "/jsc-code:issues --issues 12"`、`codex exec '$issues --issues 12'`。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -193,85 +193,85 @@ copilot plugin marketplace remove code
|
|||||||
|
|
||||||
<!-- JSC-SKILLS:START -->
|
<!-- JSC-SKILLS:START -->
|
||||||
|
|
||||||
### `code-review-resolve`
|
### `review-resolve`
|
||||||
|
|
||||||
五階段：**(A Git 同步)** 先 `fetch`，務必檢查目前分支的線上分支是否存在；存在則留在目前分支更新到最新，不存在則依序切換到遠端 `develop`／`master` 並更新到最新，找不到後備分支則停止；pull 發生衝突時告知並嘗試安全解衝突；只有來源分支與 PR 目標分支相同時，才必須從該分支建立新的工作分支，後續修復、commit、push 與 PR `head` 都使用新分支。**(B 解決)** 讀工作目錄 `.gitea/ai-review/findings.json`（Gitea AI review 產出的問題清單），依嚴重等級 **🔴 嚴重 → 🟠 高 → 🟡 中 → 🔵 低** 由高到低**逐條修復**程式碼問題或登記誤報（無法安全自動修復者標「待人工處理」不硬改），已解決或已登記誤報者才自 `findings.json` 移除。**(C 提交)** 分析工作區**所有**變更，依異動內容歸類為 `feat`/`fix`/`docs`/`style`/`refactor`/`perf`/`test`/`chore`/`revert`，**每個 type 各自一個 commit**，訊息為「`type(範圍): 一句總結`」格式，**括號內的範圍須對應實際異動的功能／模組**（例 `feat(使用者登入): 新增帳密登入流程`、`perf(物件查詢): 改用批次查詢降低 DB 往返`，而非 `feat(新增功能)` 這類重述 type 的詞）。**(D 推送)** push 當前分支：先用**認證管理器**、失敗改用 **token**、再失敗**詢問使用者**。**(E 開 PR)** 用 token 透過 **Gitea API** 對目標分支發 PR（**目標分支不明必須詢問、不可猜測**），PR 描述可選**完整版**（重新分析 `git diff` 總結）／**簡單版**（逐條列 commit 訊息）／**使用者輸入**；完成後因內文可能含 gitea token，**提醒並清除 AI 助理對話內文**。除非遇到必要決策，否則依自動執行原則直接處理；token 一律由環境變數（如 `GITEA_TOKEN`）提供，全程不明文輸出。
|
五階段：**(A Git 同步)** 先 `fetch`，務必檢查目前分支的線上分支是否存在；存在則留在目前分支更新到最新，不存在則依序切換到遠端 `develop`／`master` 並更新到最新，找不到後備分支則停止；pull 發生衝突時告知並嘗試安全解衝突；只有來源分支與 PR 目標分支相同時，才必須從該分支建立新的工作分支，後續修復、commit、push 與 PR `head` 都使用新分支。**(B 解決)** 讀工作目錄 `.gitea/ai-review/findings.json`（Gitea AI review 產出的問題清單），依嚴重等級 **🔴 嚴重 → 🟠 高 → 🟡 中 → 🔵 低** 由高到低**逐條修復**程式碼問題或登記誤報（無法安全自動修復者標「待人工處理」不硬改），已解決或已登記誤報者才自 `findings.json` 移除。**(C 提交)** 分析工作區**所有**變更，依異動內容歸類為 `feat`/`fix`/`docs`/`style`/`refactor`/`perf`/`test`/`chore`/`revert`，**每個 type 各自一個 commit**，訊息為「`type(範圍): 一句總結`」格式，**括號內的範圍須對應實際異動的功能／模組**（例 `feat(使用者登入): 新增帳密登入流程`、`perf(物件查詢): 改用批次查詢降低 DB 往返`，而非 `feat(新增功能)` 這類重述 type 的詞）。**(D 推送)** push 當前分支：先用**認證管理器**、失敗改用 **token**、再失敗**詢問使用者**。**(E 開 PR)** 用 token 透過 **Gitea API** 對目標分支發 PR（**目標分支不明必須詢問、不可猜測**），PR 描述可選**完整版**（重新分析 `git diff` 總結）／**簡單版**（逐條列 commit 訊息）／**使用者輸入**；完成後因內文可能含 gitea token，**提醒並清除 AI 助理對話內文**。除非遇到必要決策，否則依自動執行原則直接處理；token 一律由環境變數（如 `GITEA_TOKEN`）提供，全程不明文輸出。
|
||||||
|
|
||||||
參數：`[--findings <findings.json 路徑>] [--target <目標分支>] [--pr-desc <full|simple|自訂文字>] [--no-commit] [--no-pr] [--yes]`（findings 省略時預設 `.gitea/ai-review/findings.json`；`--target` 省略且需要開 PR 時必問；`--no-commit` 只修復不提交；`--no-pr` 推送但不開 PR；`--yes` 略過確認）。
|
參數：`[--findings <findings.json 路徑>] [--target <目標分支>] [--pr-desc <full|simple|自訂文字>] [--no-commit] [--no-pr] [--yes]`（findings 省略時預設 `.gitea/ai-review/findings.json`；`--target` 省略且需要開 PR 時必問；`--no-commit` 只修復不提交；`--no-pr` 推送但不開 PR；`--yes` 略過確認）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-review-resolve`，或 `/jsc:code-review-resolve --target develop --pr-desc full --yes`、`/jsc:code-review-resolve --no-pr`、`/jsc:code-review-resolve --no-commit`
|
- **Claude Code / Antigravity**：`/jsc-code:review-resolve`，或 `/jsc-code:review-resolve --target develop --pr-desc full --yes`、`/jsc-code:review-resolve --no-pr`、`/jsc-code:review-resolve --no-commit`
|
||||||
- **Codex**：`$code-review-resolve`，或 `$code-review-resolve --target develop --pr-desc simple --yes`，或用 `/skills` 選單
|
- **Codex**：`$review-resolve`，或 `$review-resolve --target develop --pr-desc simple --yes`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「讀 .gitea/ai-review/findings.json 依嚴重度逐條修好、清空該檔，把工作區變更依 conventional commit 分類提交，push 後對 develop 發 PR（完整版描述）」）自動觸發
|
- **OpenCode**：描述需求（如「讀 .gitea/ai-review/findings.json 依嚴重度逐條修好、清空該檔，把工作區變更依 conventional commit 分類提交，push 後對 develop 發 PR（完整版描述）」）自動觸發
|
||||||
|
|
||||||
### `code-issues`
|
### `issues`
|
||||||
|
|
||||||
處理一或多個 Gitea 議題的實作流程，五階段：**(A 工具選擇)** 檢查 `tea` 與 `GITEA_TOKEN`，詢問要用 `tea` 或 Gitea REST API（**已選定則跳過**）；**(B 確認專案)** 詢問議題所在專案 owner/repo，可用目前 repo 的 origin 當預設（**已知則跳過**）；**(C 選擇議題)** 列出開啟中議題後詢問要處理的議題編號，**一個或多個**（**已提供則跳過**）；**(D 彙整 TODO)** 讀取議題描述與所有留言、彙整需求，盤點既有 checklist 後整理 TODO 列表並依**影響範圍由小到大**（XS→XL）排序，既有 TODO **不足以達成議題需求時補上新 TODO 並附加到議題描述**的 `## TODO` 區塊；**(E 逐項實作)** 依排序實作每項 TODO 並驗證，**每完成一項就勾選描述 checkbox 並留言進度到議題**，全部完成後留下總結留言。**全程不建立任何草稿檔**（中間成果一律保存到議題描述或留言），輸出與留言**盡量使用表格與 Mermaid 圖**；commit／push／PR 不在自動範圍，由使用者另行指示。
|
處理一或多個 Gitea 議題的實作流程，五階段：**(A 工具選擇)** 檢查 `tea` 與 `GITEA_TOKEN`，詢問要用 `tea` 或 Gitea REST API（**已選定則跳過**）；**(B 確認專案)** 詢問議題所在專案 owner/repo，可用目前 repo 的 origin 當預設（**已知則跳過**）；**(C 選擇議題)** 列出開啟中議題後詢問要處理的議題編號，**一個或多個**（**已提供則跳過**）；**(D 彙整 TODO)** 讀取議題描述與所有留言、彙整需求，盤點既有 checklist 後整理 TODO 列表並依**影響範圍由小到大**（XS→XL）排序，既有 TODO **不足以達成議題需求時補上新 TODO 並附加到議題描述**的 `## TODO` 區塊；**(E 逐項實作)** 依排序實作每項 TODO 並驗證，**每完成一項就勾選描述 checkbox 並留言進度到議題**，全部完成後留下總結留言。**全程不建立任何草稿檔**（中間成果一律保存到議題描述或留言），輸出與留言**盡量使用表格與 Mermaid 圖**；commit／push／PR 不在自動範圍，由使用者另行指示。
|
||||||
|
|
||||||
參數：`[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以逗號分隔>] [--host <gitea 主機>] [--yes]`（帶 `--tool`／`--repo`／`--issues` 時跳過對應詢問；`--yes` 略過一般確認）。
|
參數：`[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以逗號分隔>] [--host <gitea 主機>] [--yes]`（帶 `--tool`／`--repo`／`--issues` 時跳過對應詢問；`--yes` 略過一般確認）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-issues`，或 `/jsc:code-issues --tool api --repo plugins/code --issues 12,15 --yes`
|
- **Claude Code / Antigravity**：`/jsc-code:issues`，或 `/jsc-code:issues --tool api --repo plugins/code --issues 12,15 --yes`
|
||||||
- **Codex**：`$code-issues`，或 `$code-issues --tool tea --repo plugins/code --issues 12`，或用 `/skills` 選單
|
- **Codex**：`$issues`，或 `$issues --tool tea --repo plugins/code --issues 12`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「讀 plugins/code 的 12、15 號議題，整理需求成 TODO 依影響範圍小到大排序、缺的補進議題描述，逐項實作、每完成一項留言進度」）自動觸發
|
- **OpenCode**：描述需求（如「讀 plugins/code 的 12、15 號議題，整理需求成 TODO 依影響範圍小到大排序、缺的補進議題描述，逐項實作、每完成一項留言進度」）自動觸發
|
||||||
|
|
||||||
### `code-nuget`
|
### `nuget`
|
||||||
|
|
||||||
將 C# / .NET 專案的 NuGet 套件更新到最新可用版本。流程會先探測 `.sln` / `.slnx` / `.csproj` 與 `dotnet` 工具，執行 baseline `restore` / `build`，再**依專案分組列出所有 direct / transitive 套件**與目前版本、最新版本、參考來源。接著建立 `ProjectReference` graph：若當前專案所參考的上層專案已 direct reference 相同 NuGet 套件，且該套件會透過專案參考安全傳遞，便逐一移除重複 `PackageReference`；每移除一筆都立刻 `restore` / `build` 驗證，失敗即回復。最後逐一更新 direct 套件版本（支援 Central Package Management / `Directory.Packages.props`），**每更新一個套件就 restore/build 確認專案可正常編譯**；若最新版本編譯失敗，改從目前版本之後的最小可用版本逐版升級，直到遇到第一個編譯失敗版本，保留最後一個可編譯版本並記錄失敗點。
|
將 C# / .NET 專案的 NuGet 套件更新到最新可用版本。流程會先探測 `.sln` / `.slnx` / `.csproj` 與 `dotnet` 工具，執行 baseline `restore` / `build`，再**依專案分組列出所有 direct / transitive 套件**與目前版本、最新版本、參考來源。接著建立 `ProjectReference` graph：若當前專案所參考的上層專案已 direct reference 相同 NuGet 套件，且該套件會透過專案參考安全傳遞，便逐一移除重複 `PackageReference`；每移除一筆都立刻 `restore` / `build` 驗證，失敗即回復。最後逐一更新 direct 套件版本（支援 Central Package Management / `Directory.Packages.props`），**每更新一個套件就 restore/build 確認專案可正常編譯**；若最新版本編譯失敗，改從目前版本之後的最小可用版本逐版升級，直到遇到第一個編譯失敗版本，保留最後一個可編譯版本並記錄失敗點。
|
||||||
|
|
||||||
參數：`[<solution-or-project>] [--include-prerelease] [--no-dedupe] [--build <command>] [--yes]`（目標可為 `.sln`、`.slnx` 或 `.csproj`；`--include-prerelease` 允許 prerelease；`--no-dedupe` 略過重複參考清理；`--build` 覆寫驗證指令；`--yes` 略過一般確認但不略過必要決策）。
|
參數：`[<solution-or-project>] [--include-prerelease] [--no-dedupe] [--build <command>] [--yes]`（目標可為 `.sln`、`.slnx` 或 `.csproj`；`--include-prerelease` 允許 prerelease；`--no-dedupe` 略過重複參考清理；`--build` 覆寫驗證指令；`--yes` 略過一般確認但不略過必要決策）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-nuget`，或 `/jsc:code-nuget MySolution.sln --include-prerelease`
|
- **Claude Code / Antigravity**：`/jsc-code:nuget`，或 `/jsc-code:nuget MySolution.sln --include-prerelease`
|
||||||
- **Codex**：`$code-nuget`，或 `$code-nuget src/App/App.csproj --build "dotnet build App.sln -c Release"`，或用 `/skills` 選單
|
- **Codex**：`$nuget`，或 `$nuget src/App/App.csproj --build "dotnet build App.sln -c Release"`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「把這個 .NET solution 的 NuGet 都更新到最新，先清掉 ProjectReference 已提供的重複套件，每更新一包就 build」）自動觸發
|
- **OpenCode**：描述需求（如「把這個 .NET solution 的 NuGet 都更新到最新，先清掉 ProjectReference 已提供的重複套件，每更新一包就 build」）自動觸發
|
||||||
|
|
||||||
### `code-sync`
|
### `sync`
|
||||||
|
|
||||||
透過 `GITEA_TOKEN` 把使用者有讀取權限的 Gitea 專案批次 clone 到本機並依擁有者分類。流程會先確認 token、決定 gitea 主機與目標根目錄（預設家目錄），再以 token 分頁呼叫 `GET /api/v1/user/repos` 取回**所有有讀取權限**的專案、依 `owner` 分組（預設排除 fork）；接著列出所有擁有者讓使用者**多選**（帶 `--owner` 則跳過詢問），列出選定擁有者底下的專案後，於 `<根目錄>/<擁有者>/<專案名>` 逐一處理：**不存在則 clone**（HTTPS＋token，clone 後還原乾淨 origin；或 `--ssh`），**已存在則 `fetch` → 切到 develop（再退而 master）→ `pull --ff-only` 更新到最新**。全程唯讀（不 push、不改遠端），工作區有未提交變更的專案會略過而非強制覆蓋；token 一律由環境變數提供、不寫死也不印出。
|
透過 `GITEA_TOKEN` 把使用者有讀取權限的 Gitea 專案批次 clone 到本機並依擁有者分類。流程會先確認 token、決定 gitea 主機與目標根目錄（預設家目錄），再以 token 分頁呼叫 `GET /api/v1/user/repos` 取回**所有有讀取權限**的專案、依 `owner` 分組（預設排除 fork）；接著列出所有擁有者讓使用者**多選**（帶 `--owner` 則跳過詢問），列出選定擁有者底下的專案後，於 `<根目錄>/<擁有者>/<專案名>` 逐一處理：**不存在則 clone**（HTTPS＋token，clone 後還原乾淨 origin；或 `--ssh`），**已存在則 `fetch` → 切到 develop（再退而 master）→ `pull --ff-only` 更新到最新**。全程唯讀（不 push、不改遠端），工作區有未提交變更的專案會略過而非強制覆蓋；token 一律由環境變數提供、不寫死也不印出。
|
||||||
|
|
||||||
參數：`[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>] [--host <gitea 主機>] [--include-forks] [--ssh] [--yes]`（根目錄預設家目錄；`--owner` 預先指定擁有者並跳過多選；`--host` 指定 gitea 主機；`--include-forks` 納入 fork；`--ssh` 改用 SSH clone；`--yes` 略過一般確認但不略過擁有者多選）。
|
參數：`[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>] [--host <gitea 主機>] [--include-forks] [--ssh] [--yes]`（根目錄預設家目錄；`--owner` 預先指定擁有者並跳過多選；`--host` 指定 gitea 主機；`--include-forks` 納入 fork；`--ssh` 改用 SSH clone；`--yes` 略過一般確認但不略過擁有者多選）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-sync`，或 `/jsc:code-sync --owner plugins --target-dir ~/work`、`/jsc:code-sync --include-forks --ssh`
|
- **Claude Code / Antigravity**：`/jsc-code:sync`，或 `/jsc-code:sync --owner plugins --target-dir ~/work`、`/jsc-code:sync --include-forks --ssh`
|
||||||
- **Codex**：`$code-sync`，或 `$code-sync --owner plugins --target-dir ~/work`，或用 `/skills` 選單
|
- **Codex**：`$sync`，或 `$sync --owner plugins --target-dir ~/work`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「用 GITEA_TOKEN 取得我有讀取權限的所有 Gitea 專案，依擁有者分組讓我多選，把選定擁有者的專案 clone 到家目錄；已存在的切到 develop／master 更新到最新」）自動觸發
|
- **OpenCode**：描述需求（如「用 GITEA_TOKEN 取得我有讀取權限的所有 Gitea 專案，依擁有者分組讓我多選，把選定擁有者的專案 clone 到家目錄；已存在的切到 develop／master 更新到最新」）自動觸發
|
||||||
|
|
||||||
### `code-action-docker`
|
### `action-docker`
|
||||||
|
|
||||||
把 Gitea／GitHub「Docker 容器 action」專案標準化為 **Node 主程式＋容器化**，再串接文件化流程。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把**主程式依賴鏈**的 `.js` 集中到 **`src/`**（工具設定檔與測試目錄不搬）、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`（`runs` 只設 `using: docker`＋`image: Dockerfile`，**不設相對路徑的 `entrypoint`**，入口由 Dockerfile 的絕對路徑 `ENTRYPOINT` 決定）；(C) 產生 `entrypoint.sh`，**啟動 node 前先輸出 action 名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`）再 `exec node`；(D) 依**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生**使用最新 LTS node 版本（固定 major tag）**的 `Dockerfile`，**每步內容依主程式（`src/`）實作量身決定**（先盤點相依／是否需 build／OS 層相依／入口檔並產生 `.dockerignore`，再填對應步驟，用不到的不硬塞），預設 build 基底為當前 LTS（如 `node:22`）、runtime 對應 `-slim`（如 `node:22-slim`），**多階段建置逐項明列必要產物**（不整包 COPY）縮小映像，`ENTRYPOINT` 指向 `entrypoint.sh`（絕對路徑）；(E) 對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README）。開發中需要新參數時依**參數來源優先序**處理：優先取用 runner 注入容器的 `GITHUB_*`／`GITEA_*` 執行期環境變數（即 `gitea.*`／`github.*` context 的同源資訊；docker action 的 `action.yml` 幾乎只有 `inputs`／`env` context 可用），無法取得才經使用者同意**新增 `inputs`**（容器內讀 `INPUT_*`）；`secrets`／`vars` context 在 docker action 內**一律視為不可用**（GitHub 官方文件僅記載 `inputs` context、runner 不注入 secrets；Gitea 行為無保證），需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。目錄沒有 `action.yml` 時可走**問答式從零建立**（收集名稱／輸入輸出／執行目標後產生 docker `action.yml` 與 `src/index.js` 骨架，再接後續階段）。skill 各檔的「更新時間」於最終階段（doc-funcs 完成後）**統一同步為同一時間戳**。
|
把 Gitea／GitHub「Docker 容器 action」專案標準化為 **Node 主程式＋容器化**，再串接文件化流程。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把**主程式依賴鏈**的 `.js` 集中到 **`src/`**（工具設定檔與測試目錄不搬）、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`（`runs` 只設 `using: docker`＋`image: Dockerfile`，**不設相對路徑的 `entrypoint`**，入口由 Dockerfile 的絕對路徑 `ENTRYPOINT` 決定）；(C) 產生 `entrypoint.sh`，**啟動 node 前先輸出 action 名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`）再 `exec node`；(D) 依**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生**使用最新 LTS node 版本（固定 major tag）**的 `Dockerfile`，**每步內容依主程式（`src/`）實作量身決定**（先盤點相依／是否需 build／OS 層相依／入口檔並產生 `.dockerignore`，再填對應步驟，用不到的不硬塞），預設 build 基底為當前 LTS（如 `node:22`）、runtime 對應 `-slim`（如 `node:22-slim`），**多階段建置逐項明列必要產物**（不整包 COPY）縮小映像，`ENTRYPOINT` 指向 `entrypoint.sh`（絕對路徑）；(E) 對整個專案**完整執行 `/jsc-doc:funcs`**（function 文件、`entrypoint.sh`／`Dockerfile` 逐行註解、重建 README）。開發中需要新參數時依**參數來源優先序**處理：優先取用 runner 注入容器的 `GITHUB_*`／`GITEA_*` 執行期環境變數（即 `gitea.*`／`github.*` context 的同源資訊；docker action 的 `action.yml` 幾乎只有 `inputs`／`env` context 可用），無法取得才經使用者同意**新增 `inputs`**（容器內讀 `INPUT_*`）；`secrets`／`vars` context 在 docker action 內**一律視為不可用**（GitHub 官方文件僅記載 `inputs` context、runner 不注入 secrets；Gitea 行為無保證），需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。目錄沒有 `action.yml` 時可走**問答式從零建立**（收集名稱／輸入輸出／執行目標後產生 docker `action.yml` 與 `src/index.js` 骨架，再接後續階段）。skill 各檔的「更新時間」於最終階段（funcs 完成後）**統一同步為同一時間戳**。
|
||||||
|
|
||||||
參數：`[--action-dir <action 根目錄>] [--node-version <node tag>] [--main <主程式檔>]`（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷）。
|
參數：`[--action-dir <action 根目錄>] [--node-version <node tag>] [--main <主程式檔>]`（根目錄預設目前工作目錄；node 版本預設最新；主程式自動判斷）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-action-docker`，或 `/jsc:code-action-docker --action-dir ~/work/my-action --node-version 22`
|
- **Claude Code / Antigravity**：`/jsc-code:action-docker`，或 `/jsc-code:action-docker --action-dir ~/work/my-action --node-version 22`
|
||||||
- **Codex**：`$code-action-docker`，或 `$code-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單
|
- **Codex**：`$action-docker`，或 `$action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 LTS node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發
|
- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 LTS node 版本的 Dockerfile，最後跑 funcs 補文件並重建 README」）自動觸發
|
||||||
|
|
||||||
### `code-action-composite`
|
### `action-composite`
|
||||||
|
|
||||||
把 Gitea／GitHub「composite action」專案標準化，再串接文件化流程。四階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs`、判斷是否為 composite；(B) **已是 composite 則保留既有 `steps`**，非 composite（JS／Docker）則**保守確認後對齊**為 composite（高風險先以 AskUserQuestion 確認；JS action 轉換須補 `INPUT_*` env 映射與 `outputs.value` 轉接以保留 `inputs`／`outputs` 契約；Docker 行為無法等價塞入時標「需人工確認」並建議改用 `code-action-docker`）；(C) 在 `runs.steps` **最前面注入啟動橫幅 step**，輸出 action **名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`，固定字串），並於 `action.yml` 開頭補用途／更新時間註解區塊（既有橫幅 step 則更新而非重插）；(D) 對整個專案**完整執行 `/jsc:doc-funcs`**（`action.yml` 與被引用腳本逐行註解、function 文件、重建 README）。開發中需要新參數時依**參數來源優先序**處理：優先取用 `${{ gitea.* }}`／`${{ github.* }}` context（Gitea 中兩者互為別名，composite step 內可直接使用、`run` 腳本內可讀同源 `$GITHUB_*` 環境變數），無法取得才經使用者同意**新增 `inputs`**；`secrets`／`vars` context 在 composite action 內**一律視為不可用**（GitHub 官方明文限制；Gitea act_runner 未嚴格檢查 context 可用性、行為無保證），需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。目錄沒有 `action.yml` 時可走**問答式從零建立**（收集名稱／輸入輸出／執行目標後產生 composite `action.yml` 並實作 steps，再接後續階段）。skill 各檔的「更新時間」於最終階段（doc-funcs 完成後）**統一同步為同一時間戳**。
|
把 Gitea／GitHub「composite action」專案標準化，再串接文件化流程。四階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs`、判斷是否為 composite；(B) **已是 composite 則保留既有 `steps`**，非 composite（JS／Docker）則**保守確認後對齊**為 composite（高風險先以 AskUserQuestion 確認；JS action 轉換須補 `INPUT_*` env 映射與 `outputs.value` 轉接以保留 `inputs`／`outputs` 契約；Docker 行為無法等價塞入時標「需人工確認」並建議改用 `action-docker`）；(C) 在 `runs.steps` **最前面注入啟動橫幅 step**，輸出 action **名稱／用途／更新時間**（Asia/Taipei `yyyy/MM/dd HH:mm:ss`，固定字串），並於 `action.yml` 開頭補用途／更新時間註解區塊（既有橫幅 step 則更新而非重插）；(D) 對整個專案**完整執行 `/jsc-doc:funcs`**（`action.yml` 與被引用腳本逐行註解、function 文件、重建 README）。開發中需要新參數時依**參數來源優先序**處理：優先取用 `${{ gitea.* }}`／`${{ github.* }}` context（Gitea 中兩者互為別名，composite step 內可直接使用、`run` 腳本內可讀同源 `$GITHUB_*` 環境變數），無法取得才經使用者同意**新增 `inputs`**；`secrets`／`vars` context 在 composite action 內**一律視為不可用**（GitHub 官方明文限制；Gitea act_runner 未嚴格檢查 context 可用性、行為無保證），需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。目錄沒有 `action.yml` 時可走**問答式從零建立**（收集名稱／輸入輸出／執行目標後產生 composite `action.yml` 並實作 steps，再接後續階段）。skill 各檔的「更新時間」於最終階段（funcs 完成後）**統一同步為同一時間戳**。
|
||||||
|
|
||||||
參數：`[--action-dir <action 根目錄>] [--manifest <action.yml 路徑>]`（根目錄預設目前工作目錄；manifest 自動尋找 `action.yml`／`action.yaml`）。
|
參數：`[--action-dir <action 根目錄>] [--manifest <action.yml 路徑>]`（根目錄預設目前工作目錄；manifest 自動尋找 `action.yml`／`action.yaml`）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-action-composite`，或 `/jsc:code-action-composite --action-dir ~/work/my-action`
|
- **Claude Code / Antigravity**：`/jsc-code:action-composite`，或 `/jsc-code:action-composite --action-dir ~/work/my-action`
|
||||||
- **Codex**：`$code-action-composite`，或 `$code-action-composite --action-dir ~/work/my-action`，或用 `/skills` 選單
|
- **Codex**：`$action-composite`，或 `$action-composite --action-dir ~/work/my-action`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「把這個 composite action 標準化，在 steps 最前面加一個會輸出 action 名稱／用途／更新時間的 step，最後跑 doc-funcs 補文件並重建 README」）自動觸發
|
- **OpenCode**：描述需求（如「把這個 composite action 標準化，在 steps 最前面加一個會輸出 action 名稱／用途／更新時間的 step，最後跑 funcs 補文件並重建 README」）自動觸發
|
||||||
|
|
||||||
### `code-action-node`
|
### `action-node`
|
||||||
|
|
||||||
把 Gitea／GitHub「Node（JavaScript）action」專案標準化，再串接文件化流程。node action 由 **runner 內建 Node 直接執行 `runs.main`**（不需 Docker、啟動比 docker action 快），但 **runner 不會自動 `npm install`**——這是與 docker／composite 最大的差異。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言（無 manifest 可**問答式從零建立**）；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把**主程式依賴鏈**的 `.js` 集中到 **`src/`**（工具設定檔與測試目錄不搬）、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`；(C) 對齊 `runs` 為 node action（`using: node24` + `main`，`--node-version` 可覆寫、runner 太舊退 `node20`），**`outputs` 去除 `value`**（node 只需 `description`，值於執行時寫入 `$GITHUB_OUTPUT`）、**`inputs` 由 runner 自動注入 `INPUT_*`**（不像 composite 需手動映射），並在**主程式入口最前面**以 `console.log` 輸出 action 名稱／用途／更新時間（Asia/Taipei `yyyy/MM/dd HH:mm:ss`；node action 無 `entrypoint.sh`，橫幅改在 JS 輸出）；(D) 相依處理——**零相依**則 `main` 直接指 `src/index.js`，**有相依**則以 [`@vercel/ncc`](https://github.com/vercel/ncc) 打包成 `dist/index.js`、`main` 改指 `dist/index.js` 並**把 `dist/` commit 進 repo**（確認 `.gitignore` 未忽略）；(E) 對整個專案**完整執行 `/jsc:doc-funcs`**（function 文件、`src/` 主程式與 `action.yml` 註解、重建 README）。開發中需要新參數時依**參數來源優先序**處理：主程式優先取 runner 注入的 `GITHUB_*`／`GITEA_*` 執行期環境變數，既有 `inputs` 以 `process.env.INPUT_*`（或 `core.getInput`）取用，無法取得才經使用者同意**新增 `inputs`**；`secrets`／`vars` **一律視為不可用**，需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。skill 各檔的「更新時間」於最終階段（doc-funcs 完成後）**統一同步為同一時間戳**。
|
把 Gitea／GitHub「Node（JavaScript）action」專案標準化，再串接文件化流程。node action 由 **runner 內建 Node 直接執行 `runs.main`**（不需 Docker、啟動比 docker action 快），但 **runner 不會自動 `npm install`**——這是與 docker／composite 最大的差異。五階段：(A) 找出 action 專案、讀 `action.yml`／`action.yaml` 的 `name`／`description`、判斷主程式語言（無 manifest 可**問答式從零建立**）；(B) 主程式**非 Node 則保守改寫為 Node**（高風險，先以 AskUserQuestion 確認，保留對外行為），並把**主程式依賴鏈**的 `.js` 集中到 **`src/`**（工具設定檔與測試目錄不搬）、同步更新 `require`／`import` 路徑、`package.json` 與 `action.yml`；(C) 對齊 `runs` 為 node action（`using: node24` + `main`，`--node-version` 可覆寫、runner 太舊退 `node20`），**`outputs` 去除 `value`**（node 只需 `description`，值於執行時寫入 `$GITHUB_OUTPUT`）、**`inputs` 由 runner 自動注入 `INPUT_*`**（不像 composite 需手動映射），並在**主程式入口最前面**以 `console.log` 輸出 action 名稱／用途／更新時間（Asia/Taipei `yyyy/MM/dd HH:mm:ss`；node action 無 `entrypoint.sh`，橫幅改在 JS 輸出）；(D) 相依處理——**零相依**則 `main` 直接指 `src/index.js`，**有相依**則以 [`@vercel/ncc`](https://github.com/vercel/ncc) 打包成 `dist/index.js`、`main` 改指 `dist/index.js` 並**把 `dist/` commit 進 repo**（確認 `.gitignore` 未忽略）；(E) 對整個專案**完整執行 `/jsc-doc:funcs`**（function 文件、`src/` 主程式與 `action.yml` 註解、重建 README）。開發中需要新參數時依**參數來源優先序**處理：主程式優先取 runner 注入的 `GITHUB_*`／`GITEA_*` 執行期環境變數，既有 `inputs` 以 `process.env.INPUT_*`（或 `core.getInput`）取用，無法取得才經使用者同意**新增 `inputs`**；`secrets`／`vars` **一律視為不可用**，需要時宣告為 `inputs` 由呼叫端 workflow 以 `with:` 傳入，未經同意不擅改 `inputs`／`outputs` 契約。skill 各檔的「更新時間」於最終階段（funcs 完成後）**統一同步為同一時間戳**。
|
||||||
|
|
||||||
參數：`[--action-dir <action 根目錄>] [--node-version <node runtime>] [--main <主程式檔>]`（根目錄預設目前工作目錄；node 版本預設 `node24`；主程式自動判斷）。
|
參數：`[--action-dir <action 根目錄>] [--node-version <node runtime>] [--main <主程式檔>]`（根目錄預設目前工作目錄；node 版本預設 `node24`；主程式自動判斷）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-action-node`，或 `/jsc:code-action-node --action-dir ~/work/my-action --node-version node24`
|
- **Claude Code / Antigravity**：`/jsc-code:action-node`，或 `/jsc-code:action-node --action-dir ~/work/my-action --node-version node24`
|
||||||
- **Codex**：`$code-action-node`，或 `$code-action-node --action-dir ~/work/my-action`，或用 `/skills` 選單
|
- **Codex**：`$action-node`，或 `$action-node --action-dir ~/work/my-action`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，對齊 action.yml 為 node action、在主程式最前面輸出 action 名稱／用途／更新時間，有相依就用 ncc 打包成 dist 並 commit，最後跑 doc-funcs 補文件並重建 README」）自動觸發
|
- **OpenCode**：描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，對齊 action.yml 為 node action、在主程式最前面輸出 action 名稱／用途／更新時間，有相依就用 ncc 打包成 dist 並 commit，最後跑 funcs 補文件並重建 README」）自動觸發
|
||||||
|
|
||||||
### `code-image`
|
### `image`
|
||||||
|
|
||||||
把專案既有的 `Dockerfile` **整理成固定六步流程**，再串接文件化流程。三階段：(A) 找出專案根目錄、定位目標 `Dockerfile`（找不到則詢問、**不臆造**；要產生全新 action 容器請改用 `code-action-docker`），讀現有指令、判斷語言／生態與既有 base image／建置流程；(B) 在**保留建置行為**前提下，把指令重整／歸位為**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）：可調參數集中於檔首 `ARG`、相依描述先 `COPY` 以利 layer 快取、**多階段建置**讓 runtime 改用較小基底（`*-slim`／`*-alpine`／`distroless` 等）只帶執行所需產物；`ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV` 等對外契約不動，**無法保證等價的重整先以 AskUserQuestion 確認**（可選最小重排或只補註解）；(C) 對整個專案**完整執行 `/jsc:doc-funcs`**（`Dockerfile` 等指令檔逐行註解、function 文件、重建 README）。
|
把專案既有的 `Dockerfile` **整理成固定六步流程**，再串接文件化流程。三階段：(A) 找出專案根目錄、定位目標 `Dockerfile`（找不到則詢問、**不臆造**；要產生全新 action 容器請改用 `action-docker`），讀現有指令、判斷語言／生態與既有 base image／建置流程；(B) 在**保留建置行為**前提下，把指令重整／歸位為**六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）：可調參數集中於檔首 `ARG`、相依描述先 `COPY` 以利 layer 快取、**多階段建置**讓 runtime 改用較小基底（`*-slim`／`*-alpine`／`distroless` 等）只帶執行所需產物；`ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV` 等對外契約不動，**無法保證等價的重整先以 AskUserQuestion 確認**（可選最小重排或只補註解）；(C) 對整個專案**完整執行 `/jsc-doc:funcs`**（`Dockerfile` 等指令檔逐行註解、function 文件、重建 README）。
|
||||||
|
|
||||||
參數：`[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路徑>] [--yes]`（專案根目錄預設目前工作目錄；Dockerfile 自動定位、多個時詢問；`--yes` 略過一般確認，但「重整無法保證行為等價」與 doc-funcs 的實作詢問仍會中斷）。
|
參數：`[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路徑>] [--yes]`（專案根目錄預設目前工作目錄；Dockerfile 自動定位、多個時詢問；`--yes` 略過一般確認，但「重整無法保證行為等價」與 funcs 的實作詢問仍會中斷）。
|
||||||
|
|
||||||
- **Claude Code / Antigravity**：`/jsc:code-image`，或 `/jsc:code-image --project-dir ~/work/my-app --dockerfile build/Dockerfile`
|
- **Claude Code / Antigravity**：`/jsc-code:image`，或 `/jsc-code:image --project-dir ~/work/my-app --dockerfile build/Dockerfile`
|
||||||
- **Codex**：`$code-image`，或 `$code-image --dockerfile docker/Dockerfile`，或用 `/skills` 選單
|
- **Codex**：`$image`，或 `$image --dockerfile docker/Dockerfile`，或用 `/skills` 選單
|
||||||
- **OpenCode**：描述需求（如「把這個專案的 Dockerfile 整理成參數處理→安裝套件→複製檔案→執行程序→縮小映像檔→設定入口六步、用多階段建置縮小映像，最後跑 doc-funcs 補文件並重建 README」）自動觸發
|
- **OpenCode**：描述需求（如「把這個專案的 Dockerfile 整理成參數處理→安裝套件→複製檔案→執行程序→縮小映像檔→設定入口六步、用多階段建置縮小映像，最後跑 funcs 補文件並重建 README」）自動觸發
|
||||||
|
|
||||||
<!-- JSC-SKILLS:END -->
|
<!-- JSC-SKILLS:END -->
|
||||||
|
|
||||||
@@ -279,16 +279,16 @@ copilot plugin marketplace remove code
|
|||||||
|
|
||||||
## 新增一個 skill
|
## 新增一個 skill
|
||||||
|
|
||||||
1. 複製既有 skill 作範本：`cp -r skills/code-issues skills/<your-skill-name>`
|
1. 複製既有 skill 作範本：`cp -r skills/issues skills/<your-skill-name>`
|
||||||
2. 編輯 `skills/<your-skill-name>/SKILL.md` 的 frontmatter：
|
2. 編輯 `skills/<your-skill-name>/SKILL.md` 的 frontmatter：
|
||||||
- `name`：小寫、數字、連字號（`-`），最長 64 字元。**這就是 Claude Code / Antigravity 的 `/jsc:<name>`**。
|
- `name`：小寫、數字、連字號（`-`），最長 64 字元。**這就是 Claude Code / Antigravity 的 `/jsc-code:<name>`**。
|
||||||
- `description`：第三人稱，寫清楚「何時用、何時不用」與觸發關鍵字 — 這是各助理自動載入的唯一依據。
|
- `description`：第三人稱，寫清楚「何時用、何時不用」與觸發關鍵字 — 這是各助理自動載入的唯一依據。
|
||||||
3. 在內文寫下 skill 的具體步驟。
|
3. 在內文寫下 skill 的具體步驟。
|
||||||
4. 手動把這個 skill 補進上方「Skills 目錄」區塊。
|
4. 手動把這個 skill 補進上方「Skills 目錄」區塊。
|
||||||
5. **bump 版本並 push**：各助理都以 git 內容/版本判斷更新，請把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 三個 manifest 的 `version` 一起 bump，commit 後 push 到 gitea。
|
5. **bump 版本並 push**：各助理都以 git 內容/版本判斷更新，請把 `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 三個 manifest 的 `version` 一起 bump，commit 後 push 到 gitea。
|
||||||
6. 讓各助理更新：
|
6. 讓各助理更新：
|
||||||
- Claude：`claude plugin update jsc@code`
|
- Claude：`claude plugin update jsc-code@code`
|
||||||
- Codex：`codex plugin marketplace upgrade code`
|
- Codex：`codex plugin marketplace upgrade code`
|
||||||
- Antigravity：`git -C ~/jsc-plugin pull && agy plugin uninstall jsc && agy plugin install ~/jsc-plugin`
|
- Antigravity：`git -C ~/jsc-plugin pull && agy plugin uninstall jsc-code && agy plugin install ~/jsc-plugin`
|
||||||
- OpenCode：`git pull` 後重新複製 `skills/`
|
- OpenCode：`git pull` 後重新複製 `skills/`
|
||||||
- Copilot：`copilot plugin marketplace update code && copilot plugin update jsc@code`
|
- Copilot：`copilot plugin marketplace update code && copilot plugin update jsc-code@code`
|
||||||
|
|||||||
@@ -1,31 +0,0 @@
|
|||||||
{
|
|
||||||
"hooks": {
|
|
||||||
"SessionStart": [
|
|
||||||
{
|
|
||||||
"hooks": [
|
|
||||||
{
|
|
||||||
"type": "command",
|
|
||||||
"command": "rel='scripts/role/role_load.sh'; own='generic'; root=\"${CLAUDE_PLUGIN_ROOT:-}\"; if [ -n \"$root\" ] && [ -f \"$root/$rel\" ]; then exec \"$root/$rel\"; fi; for base in \"$HOME/.claude/plugins/cache\" \"$HOME/.codex/plugins/cache\"; do for dir in \"$base/$own/jsc\" \"$base\"; do s=$(find \"$dir\" -path \"*/jsc/*/$rel\" -type f 2>/dev/null | sort -V | tail -n 1); if [ -n \"$s\" ]; then exec \"$s\"; fi; done; done; exit 0",
|
|
||||||
"timeout": 20
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"Stop": [
|
|
||||||
{
|
|
||||||
"hooks": [
|
|
||||||
{
|
|
||||||
"type": "command",
|
|
||||||
"command": "rel='scripts/worklog/worklog.sh'; own='doc'; root=\"${CLAUDE_PLUGIN_ROOT:-}\"; if [ -n \"$root\" ] && [ -f \"$root/$rel\" ]; then exec \"$root/$rel\"; fi; for base in \"$HOME/.claude/plugins/cache\" \"$HOME/.codex/plugins/cache\"; do for dir in \"$base/$own/jsc\" \"$base\"; do s=$(find \"$dir\" -path \"*/jsc/*/$rel\" -type f 2>/dev/null | sort -V | tail -n 1); if [ -n \"$s\" ]; then exec \"$s\"; fi; done; done; exit 0",
|
|
||||||
"timeout": 60
|
|
||||||
},
|
|
||||||
{
|
|
||||||
"type": "command",
|
|
||||||
"command": "rel='scripts/role/role_capture.sh'; own='generic'; root=\"${CLAUDE_PLUGIN_ROOT:-}\"; if [ -n \"$root\" ] && [ -f \"$root/$rel\" ]; then exec \"$root/$rel\"; fi; for base in \"$HOME/.claude/plugins/cache\" \"$HOME/.codex/plugins/cache\"; do for dir in \"$base/$own/jsc\" \"$base\"; do s=$(find \"$dir\" -path \"*/jsc/*/$rel\" -type f 2>/dev/null | sort -V | tail -n 1); if [ -n \"$s\" ]; then exec \"$s\"; fi; done; done; exit 0",
|
|
||||||
"timeout": 60
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
+3
-3
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "jsc",
|
"name": "jsc-code",
|
||||||
"version": "0.1.0",
|
"version": "0.0.1",
|
||||||
"description": "JSC 程式碼工作流 plugin，提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc: 前綴呼叫。",
|
"description": "JSC 程式碼工作流 plugin，提供 Gitea AI review findings 修復/PR 流程、Gitea 議題 TODO 彙整與逐項實作、C# / .NET NuGet 套件更新、Gitea 專案批次同步，以及 action / Dockerfile 標準化流程；於 Antigravity 以 /jsc-code: 前綴呼叫。",
|
||||||
"skills": "./skills/"
|
"skills": "./skills/"
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,19 +1,19 @@
|
|||||||
---
|
---
|
||||||
name: code-action-composite
|
name: action-composite
|
||||||
description: 將 Gitea／GitHub「composite action」專案標準化（目錄沒有 action manifest 時可問答式從零建立）並串接文件化流程：(1) 確認 action 為 composite（`runs.using: composite`），非 composite 則保守確認後對齊；(2) 在 `runs.steps` 最前面注入啟動橫幅 step，輸出 action 名稱／用途／更新時間（Asia/Taipei `yyyy/MM/dd HH:mm:ss`），並於 `action.yml` 開頭補用途／更新時間註解區塊；(3) 開發中需要新參數時優先取用 `${{ gitea.* }}`／`${{ github.* }}` context，無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` context 在 composite action 內一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(4) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說整理 composite action、從零建立／產生一個 composite action、把 action 標準化為 composite、讓 composite action 啟動時印名稱／用途／更新時間、處理 composite action 參數來源、對 composite action 補文件，或提到 code-action-composite 時觸發。不適用於：Docker 容器 action（用 code-action-docker）、或不需 action 化／文件化的一般 repo。
|
description: 將 Gitea／GitHub「composite action」專案標準化（目錄沒有 action manifest 時可問答式從零建立）並串接文件化流程：(1) 確認 action 為 composite（`runs.using: composite`），非 composite 則保守確認後對齊；(2) 在 `runs.steps` 最前面注入啟動橫幅 step，輸出 action 名稱／用途／更新時間（Asia/Taipei `yyyy/MM/dd HH:mm:ss`），並於 `action.yml` 開頭補用途／更新時間註解區塊；(3) 開發中需要新參數時優先取用 `${{ gitea.* }}`／`${{ github.* }}` context，無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` context 在 composite action 內一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(4) 最後完整執行 `/jsc-doc:funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說整理 composite action、從零建立／產生一個 composite action、把 action 標準化為 composite、讓 composite action 啟動時印名稱／用途／更新時間、處理 composite action 參數來源、對 composite action 補文件，或提到 action-composite 時觸發。不適用於：Docker 容器 action（用 action-docker）、或不需 action 化／文件化的一般 repo。
|
||||||
argument-hint: "[--action-dir <action 根目錄>] [--manifest <action.yml 路徑>]"
|
argument-hint: "[--action-dir <action 根目錄>] [--manifest <action.yml 路徑>]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-action-composite — composite action 標準化＋文件化
|
# action-composite — composite action 標準化＋文件化
|
||||||
|
|
||||||
四階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷是否為 composite），再**確認／對齊為 composite action**，接著在 `runs.steps` 最前面**注入會輸出 action 名稱／用途／更新時間的啟動橫幅 step**，最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 composite `action.yml`，再進入後續階段。
|
四階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷是否為 composite），再**確認／對齊為 composite action**，接著在 `runs.steps` 最前面**注入會輸出 action 名稱／用途／更新時間的啟動橫幅 step**，最後**完整執行 `/jsc-doc:funcs` 處理流程**替整個專案補文件並重建 README。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 composite `action.yml`，再進入後續階段。
|
||||||
|
|
||||||
| 階段 | 動作 |
|
| 階段 | 動作 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs` → 判斷是否為 composite（無 manifest 可走 A1a 從零建立） |
|
| A. 前置設定與偵測 | 決定 action 根目錄 → 讀 `action.yml`／`action.yaml` 的 `name`／`description`／`runs` → 判斷是否為 composite（無 manifest 可走 A1a 從零建立） |
|
||||||
| B. 對齊為 composite | 已是 composite 則保留既有 `steps`；非 composite 則**保守確認後對齊**（高風險，先確認），整理被引用的腳本路徑 |
|
| B. 對齊為 composite | 已是 composite 則保留既有 `steps`；非 composite 則**保守確認後對齊**（高風險，先確認），整理被引用的腳本路徑 |
|
||||||
| C. 注入啟動橫幅 step | 在 `runs.steps` 最前面插入一個 shell step，輸出 action **名稱／用途／更新時間**；並於 `action.yml` 開頭補用途／更新時間註解區塊 |
|
| C. 注入啟動橫幅 step | 在 `runs.steps` 最前面插入一個 shell step，輸出 action **名稱／用途／更新時間**；並於 `action.yml` 開頭補用途／更新時間註解區塊 |
|
||||||
| D. 串接 doc-funcs | 對整個 action 專案完整執行 `/jsc:doc-funcs` 流程（function 文件、指令檔逐行註解、重建 README） |
|
| D. 串接 funcs | 對整個 action 專案完整執行 `/jsc-doc:funcs` 流程（function 文件、指令檔逐行註解、重建 README） |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -21,24 +21,24 @@ argument-hint: "[--action-dir <action 根目錄>] [--manifest <action.yml 路徑
|
|||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
||||||
- `/jsc:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）、`git mv` 保留歷史。
|
- `/jsc-generic:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）、`git mv` 保留歷史。
|
||||||
- `/jsc:spec-action-params`：action 參數來源優先序（context → 經同意新增 `inputs`）、`secrets`／`vars` 一律視為不可用。
|
- `/jsc-generic:spec-action-params`：action 參數來源優先序（context → 經同意新增 `inputs`）、`secrets`／`vars` 一律視為不可用。
|
||||||
- `/jsc:spec-time-log`：更新時間 Asia/Taipei `yyyy/MM/dd HH:mm:ss`、完成後統一同步時間戳。
|
- `/jsc-generic:spec-time-log`：更新時間 Asia/Taipei `yyyy/MM/dd HH:mm:ss`、完成後統一同步時間戳。
|
||||||
- `/jsc:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc:doc-funcs` 的標準流程。
|
- `/jsc-generic:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc-doc:funcs` 的標準流程。
|
||||||
|
|
||||||
本 skill 特有補充：
|
本 skill 特有補充：
|
||||||
|
|
||||||
- **一定會中斷詢問的點**：階段 B 主 action「非 composite 需對齊」時（破壞性，須先確認），以及階段 D 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。
|
- **一定會中斷詢問的點**：階段 B 主 action「非 composite 需對齊」時（破壞性，須先確認），以及階段 D 由 `/jsc-doc:funcs` 自身的「如何實作」詢問。
|
||||||
- **保留行為**：對齊 composite 與注入橫幅 step 只「補強」既有流程，不得擅自改變既有 `steps` 的執行順序、輸入（`inputs`）／輸出（`outputs`）契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依 `/jsc:spec-action-params` 經使用者同意後為之。
|
- **保留行為**：對齊 composite 與注入橫幅 step 只「補強」既有流程，不得擅自改變既有 `steps` 的執行順序、輸入（`inputs`）／輸出（`outputs`）契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依 `/jsc-generic:spec-action-params` 經使用者同意後為之。
|
||||||
- **本 skill 只動**：action 專案根目錄內的 `action.yml`／`action.yaml`、其 `steps` 直接引用的內嵌腳本（如 `*.sh`／`*.ps1`），以及階段 D 由 doc-funcs 流程處理的目標。
|
- **本 skill 只動**：action 專案根目錄內的 `action.yml`／`action.yaml`、其 `steps` 直接引用的內嵌腳本（如 `*.sh`／`*.ps1`），以及階段 D 由 funcs 流程處理的目標。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 參數來源優先序（開發中需要新參數時）
|
## 參數來源優先序（開發中需要新參數時）
|
||||||
|
|
||||||
從零建立（A1a）、對齊 composite（階段 B）、注入橫幅 step（階段 C）或補強被引用腳本的過程中，若需要新的參數值，一律依 `/jsc:spec-action-params` 的優先序處理：composite 的 `runs.steps` 內優先取 `${{ gitea.* }}`／`${{ github.* }}` context（建議寫 `github.*` 以相容兩邊；`run` 腳本內可改讀 `$GITHUB_*` 環境變數），取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端 workflow 傳入（範例見該 spec）。
|
從零建立（A1a）、對齊 composite（階段 B）、注入橫幅 step（階段 C）或補強被引用腳本的過程中，若需要新的參數值，一律依 `/jsc-generic:spec-action-params` 的優先序處理：composite 的 `runs.steps` 內優先取 `${{ gitea.* }}`／`${{ github.* }}` context（建議寫 `github.*` 以相容兩邊；`run` 腳本內可改讀 `$GITHUB_*` 環境變數），取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端 workflow 傳入（範例見該 spec）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -89,7 +89,7 @@ argument-hint: "[--action-dir <action 根目錄>] [--manifest <action.yml 路徑
|
|||||||
|
|
||||||
輸出偵測結果（action 名稱、用途、`runs.using`、是否為 composite、既有 step 數量），再進入階段 B。
|
輸出偵測結果（action 名稱、用途、`runs.using`、是否為 composite、既有 step 數量），再進入階段 B。
|
||||||
|
|
||||||
> 若偵測為 **Docker 容器 action**，此處**僅輸出偵測結果**並提醒可改用 `/jsc:code-action-docker`，**不詢問**；是否對齊／維持原樣／改用 code-action-docker 的決策，統一由階段 B2 的一次 `AskUserQuestion` 收斂。
|
> 若偵測為 **Docker 容器 action**，此處**僅輸出偵測結果**並提醒可改用 `/jsc-code:action-docker`，**不詢問**；是否對齊／維持原樣／改用 action-docker 的決策，統一由階段 B2 的一次 `AskUserQuestion` 收斂。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -102,14 +102,14 @@ argument-hint: "[--action-dir <action 根目錄>] [--manifest <action.yml 路徑
|
|||||||
|
|
||||||
### B2. 非 composite（需對齊）
|
### B2. 非 composite（需對齊）
|
||||||
|
|
||||||
這是**破壞性高風險決策**：先以 `AskUserQuestion` 向使用者確認，選項至少含「對齊為 composite」「維持原樣只做文件化（略過對齊）」「改用 code-action-docker」「其他」。經確認「對齊為 composite」後才改寫：
|
這是**破壞性高風險決策**：先以 `AskUserQuestion` 向使用者確認，選項至少含「對齊為 composite」「維持原樣只做文件化（略過對齊）」「改用 action-docker」「其他」。經確認「對齊為 composite」後才改寫：
|
||||||
|
|
||||||
- 將 `runs` 保守對齊為 composite，把原執行入口轉為 composite step：
|
- 將 `runs` 保守對齊為 composite，把原執行入口轉為 composite step：
|
||||||
- 原 JS action（`runs.using: node*`，`runs.main: <x>.js`）→ 轉為一個 `run` step，於 step 內以 `node <x>.js` 執行（`shell: bash`）。composite step **不會自動注入 `INPUT_*` 環境變數、也不會自動轉接 outputs**，必須手動補齊兩段映射（見下方範例）：
|
- 原 JS action（`runs.using: node*`，`runs.main: <x>.js`）→ 轉為一個 `run` step，於 step 內以 `node <x>.js` 執行（`shell: bash`）。composite step **不會自動注入 `INPUT_*` 環境變數、也不會自動轉接 outputs**，必須手動補齊兩段映射（見下方範例）：
|
||||||
- **inputs 映射**：step 加 `env:`，逐一宣告 `INPUT_<大寫名稱>: ${{ inputs.<name> }}`——主程式的 `getInput()`／`process.env.INPUT_*` 才拿得到值。
|
- **inputs 映射**：step 加 `env:`，逐一宣告 `INPUT_<大寫名稱>: ${{ inputs.<name> }}`——主程式的 `getInput()`／`process.env.INPUT_*` 才拿得到值。
|
||||||
- **outputs 轉接**：step 設 `id`，action 層 `outputs` 逐一宣告 `value: ${{ steps.<id>.outputs.<name> }}`（主程式寫入 `$GITHUB_OUTPUT` 的值由此轉出）。
|
- **outputs 轉接**：step 設 `id`，action 層 `outputs` 逐一宣告 `value: ${{ steps.<id>.outputs.<name> }}`（主程式寫入 `$GITHUB_OUTPUT` 的值由此轉出）。
|
||||||
- **硬條件**：無法完成上述兩項映射（inputs／outputs 無法逐一對應）時**不對齊**，以 `# 需人工確認` 標註並回報。
|
- **硬條件**：無法完成上述兩項映射（inputs／outputs 無法逐一對應）時**不對齊**，以 `# 需人工確認` 標註並回報。
|
||||||
- 原 Docker action（`runs.using: docker`）→ Docker 行為通常無法可靠等價地塞進 composite；**不臆測改寫**，以回報＋`# 需人工確認` 標註，並建議改用 `/jsc:code-action-docker`。
|
- 原 Docker action（`runs.using: docker`）→ Docker 行為通常無法可靠等價地塞進 composite；**不臆測改寫**，以回報＋`# 需人工確認` 標註，並建議改用 `/jsc-code:action-docker`。
|
||||||
- 任何無法可靠等價對齊處，**不臆測**：以 `# 需人工確認：...` 標註並回報，保留原檔行為。
|
- 任何無法可靠等價對齊處，**不臆測**：以 `# 需人工確認：...` 標註並回報，保留原檔行為。
|
||||||
- 對齊過程需要新的參數值（如 token、repo 資訊、外部設定）時，依「參數來源優先序」處理，不逕自新增 `inputs`。
|
- 對齊過程需要新的參數值（如 token、repo 資訊、外部設定）時，依「參數來源優先序」處理，不逕自新增 `inputs`。
|
||||||
|
|
||||||
@@ -142,7 +142,7 @@ runs:
|
|||||||
|
|
||||||
在 `runs.steps` **最前面**插入（或更新）一個輸出橫幅的 step，讓 composite action 一啟動就**輸出 action 名稱、用途、更新時間**；並於 `action.yml` 開頭補用途／更新時間註解區塊。
|
在 `runs.steps` **最前面**插入（或更新）一個輸出橫幅的 step，讓 composite action 一啟動就**輸出 action 名稱、用途、更新時間**；並於 `action.yml` 開頭補用途／更新時間註解區塊。
|
||||||
|
|
||||||
- **更新時間**依 `/jsc:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 D 完成後會統一同步各處時間戳**（見階段 D）。
|
- **更新時間**依 `/jsc-generic:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 D 完成後會統一同步各處時間戳**（見階段 D）。
|
||||||
- 名稱／用途取自階段 A2 的 `action.yml`（缺漏時以「（未提供）」標示）。
|
- 名稱／用途取自階段 A2 的 `action.yml`（缺漏時以「（未提供）」標示）。
|
||||||
- 橫幅 step 須有可辨識的 `name`（如 `顯示 action 資訊`）與 `shell: bash`；其後緊接既有／對齊後的 steps，**不更動既有 steps**。
|
- 橫幅 step 須有可辨識的 `name`（如 `顯示 action 資訊`）與 `shell: bash`；其後緊接既有／對齊後的 steps，**不更動既有 steps**。
|
||||||
- 若已存在本 skill 先前插入的橫幅 step（依 `name` 辨識），則**更新**其內容與更新時間，不重複插入。
|
- 若已存在本 skill 先前插入的橫幅 step（依 `name` 辨識），則**更新**其內容與更新時間，不重複插入。
|
||||||
@@ -156,7 +156,7 @@ description: <action description>
|
|||||||
runs:
|
runs:
|
||||||
using: composite
|
using: composite
|
||||||
steps:
|
steps:
|
||||||
# 啟動橫幅：輸出名稱／用途／更新時間（此 step 由 code-action-composite 產生）
|
# 啟動橫幅：輸出名稱／用途／更新時間（此 step 由 action-composite 產生）
|
||||||
- name: 顯示 action 資訊
|
- name: 顯示 action 資訊
|
||||||
shell: bash
|
shell: bash
|
||||||
run: |
|
run: |
|
||||||
@@ -171,14 +171,14 @@ runs:
|
|||||||
run: node ./index.js
|
run: node ./index.js
|
||||||
```
|
```
|
||||||
|
|
||||||
- `action.yml` 開頭的「用途／更新時間」註解區塊與每行註解，最終會在階段 D 由 `/jsc:doc-funcs` 的指令檔流程統一補齊／覆寫為標準格式（用途與更新日期同一註解區塊、逐行註解）；本階段先確保**執行期橫幅輸出**正確即可。
|
- `action.yml` 開頭的「用途／更新時間」註解區塊與每行註解，最終會在階段 D 由 `/jsc-doc:funcs` 的指令檔流程統一補齊／覆寫為標準格式（用途與更新日期同一註解區塊、逐行註解）；本階段先確保**執行期橫幅輸出**正確即可。
|
||||||
- 自我檢查：插入橫幅 step 後 YAML 仍可解析（縮排、`steps` 為 list、每個 `run` step 都有 `shell`），且 `inputs`／`outputs` 未被更動。
|
- 自我檢查：插入橫幅 step 後 YAML 仍可解析（縮排、`steps` 為 list、每個 `run` step 都有 `shell`），且 `inputs`／`outputs` 未被更動。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 階段 D：完整執行 /jsc:doc-funcs 處理流程
|
## 階段 D：完整執行 /jsc-doc:funcs 處理流程
|
||||||
|
|
||||||
標準化完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README）。完成後依該 spec **統一時間戳**：回頭同步橫幅 step 內文、`action.yml` 開頭註解區塊與 README 的更新時間，確保各處一致。
|
標準化完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc-generic:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc-doc:funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README）。完成後依該 spec **統一時間戳**：回頭同步橫幅 step 內文、`action.yml` 開頭註解區塊與 README 的更新時間，確保各處一致。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -189,7 +189,7 @@ runs:
|
|||||||
- **階段 A**：action 根目錄、manifest 路徑、action 名稱／用途、`runs.using`、是否為 composite、既有 step 數量；若走 A1a 從零建立，列出問答收集結果（名稱／輸入輸出／目標）。
|
- **階段 A**：action 根目錄、manifest 路徑、action 名稱／用途、`runs.using`、是否為 composite、既有 step 數量；若走 A1a 從零建立，列出問答收集結果（名稱／輸入輸出／目標）。
|
||||||
- **階段 B**：是否對齊為 composite（及對齊摘要與「需人工確認」清單），或維持原樣的理由；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。
|
- **階段 B**：是否對齊為 composite（及對齊摘要與「需人工確認」清單），或維持原樣的理由；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。
|
||||||
- **階段 C**：橫幅 step 的輸出內容（名稱／用途／更新時間）與插入位置，並確認既有 steps、`inputs`／`outputs` 未被破壞。
|
- **階段 C**：橫幅 step 的輸出內容（名稱／用途／更新時間）與插入位置，並確認既有 steps、`inputs`／`outputs` 未被破壞。
|
||||||
- **階段 D**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
- **階段 D**：funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
||||||
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `action.yml` 可正常解析、composite action 能正確啟動並輸出橫幅。
|
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `action.yml` 可正常解析、composite action 能正確啟動並輸出橫幅。
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -200,6 +200,6 @@ runs:
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-action-composite`，或 `/jsc:code-action-composite --action-dir ~/work/my-action` |
|
| Claude Code / Antigravity | `/jsc-code:action-composite`，或 `/jsc-code:action-composite --action-dir ~/work/my-action` |
|
||||||
| Codex | `$code-action-composite`，或 `$code-action-composite --action-dir ~/work/my-action`，或用 `/skills` 選單 |
|
| Codex | `$action-composite`，或 `$action-composite --action-dir ~/work/my-action`，或用 `/skills` 選單 |
|
||||||
| OpenCode | 描述需求（如「把這個 composite action 標準化，在 steps 最前面加一個會輸出 action 名稱／用途／更新時間的 step，最後跑 doc-funcs 補文件並重建 README」）自動觸發 |
|
| OpenCode | 描述需求（如「把這個 composite action 標準化，在 steps 最前面加一個會輸出 action 名稱／用途／更新時間的 step，最後跑 funcs 補文件並重建 README」）自動觸發 |
|
||||||
@@ -1,12 +1,12 @@
|
|||||||
---
|
---
|
||||||
name: code-action-docker
|
name: action-docker
|
||||||
description: 將 Gitea／GitHub「Docker 容器 action」專案標準化為 Node 主程式＋容器化（目錄沒有 action manifest 時可問答式從零建立），並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且主程式及其依賴鏈的 `.js` 檔集中到 `src/` 資料夾（工具設定檔與測試目錄不搬）；(2) 產生 `entrypoint.sh`，啟動前先輸出 action 名稱／用途／更新時間，再執行 node 主程式；(3) 產生使用最新 LTS node 版本的 `Dockerfile`；(4) 開發中需要新參數時優先取用 runner 注入的 `GITHUB_*`（Gitea 亦有 `GITEA_*`）執行期環境變數（即 `gitea.*`／`github.*` context 的同源資訊），無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` context 在 docker action 內一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(5) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 docker／node、從零建立／產生一個 docker action、容器化 action、action 主程式 node 化、把 js 收進 src、產 entrypoint.sh／Dockerfile 給 action、處理 docker action 參數來源，或提到 code-action-docker 時觸發。不適用於：composite action（用 code-action-composite）、純前端打包、或不需容器化的一般 repo。
|
description: 將 Gitea／GitHub「Docker 容器 action」專案標準化為 Node 主程式＋容器化（目錄沒有 action manifest 時可問答式從零建立），並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且主程式及其依賴鏈的 `.js` 檔集中到 `src/` 資料夾（工具設定檔與測試目錄不搬）；(2) 產生 `entrypoint.sh`，啟動前先輸出 action 名稱／用途／更新時間，再執行 node 主程式；(3) 產生使用最新 LTS node 版本的 `Dockerfile`；(4) 開發中需要新參數時優先取用 runner 注入的 `GITHUB_*`（Gitea 亦有 `GITEA_*`）執行期環境變數（即 `gitea.*`／`github.*` context 的同源資訊），無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` context 在 docker action 內一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(5) 最後完整執行 `/jsc-doc:funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 docker／node、從零建立／產生一個 docker action、容器化 action、action 主程式 node 化、把 js 收進 src、產 entrypoint.sh／Dockerfile 給 action、處理 docker action 參數來源，或提到 action-docker 時觸發。不適用於：composite action（用 action-composite）、純前端打包、或不需容器化的一般 repo。
|
||||||
argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [--main <主程式檔>]"
|
argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [--main <主程式檔>]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-action-docker — action 容器化（Node 主程式）＋文件化
|
# action-docker — action 容器化（Node 主程式）＋文件化
|
||||||
|
|
||||||
五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將主程式依賴鏈的 `.js` 收進 `src/`**，接著產生**啟動前先輸出 action 名稱／用途／更新時間的 `entrypoint.sh`**，然後產生**使用最新 LTS node 版本的 `Dockerfile`**（並對齊 `action.yml` 的 docker 設定），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。產出的 docker action 需在**具 Docker 能力的 runner（docker 模式）**上執行。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 `action.yml` 與 Node 主程式骨架，再進入後續階段。
|
五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將主程式依賴鏈的 `.js` 收進 `src/`**，接著產生**啟動前先輸出 action 名稱／用途／更新時間的 `entrypoint.sh`**，然後產生**使用最新 LTS node 版本的 `Dockerfile`**（並對齊 `action.yml` 的 docker 設定），最後**完整執行 `/jsc-doc:funcs` 處理流程**替整個專案補文件並重建 README。產出的 docker action 需在**具 Docker 能力的 runner（docker 模式）**上執行。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 `action.yml` 與 Node 主程式骨架，再進入後續階段。
|
||||||
|
|
||||||
| 階段 | 動作 |
|
| 階段 | 動作 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
@@ -14,7 +14,7 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [-
|
|||||||
| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 主程式依賴鏈的 `.js` 集中到 `src/`，更新所有引用、`package.json`、`action.yml` |
|
| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 主程式依賴鏈的 `.js` 集中到 `src/`，更新所有引用、`package.json`、`action.yml` |
|
||||||
| C. entrypoint.sh | 產生 `entrypoint.sh`：先輸出 action **名稱／用途／更新時間**，再 `exec` node 主程式 |
|
| C. entrypoint.sh | 產生 `entrypoint.sh`：先輸出 action **名稱／用途／更新時間**，再 `exec` node 主程式 |
|
||||||
| D. Dockerfile | 依六步流程（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生使用**最新 LTS node 版本**的 `Dockerfile`，多階段建置縮小映像、`ENTRYPOINT` 指向 `entrypoint.sh` |
|
| D. Dockerfile | 依六步流程（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口）產生使用**最新 LTS node 版本**的 `Dockerfile`，多階段建置縮小映像、`ENTRYPOINT` 指向 `entrypoint.sh` |
|
||||||
| E. 串接 doc-funcs | 對整個 action 專案完整執行 `/jsc:doc-funcs` 流程（function 文件、指令檔逐行註解、重建 README） |
|
| E. 串接 funcs | 對整個 action 專案完整執行 `/jsc-doc:funcs` 流程（function 文件、指令檔逐行註解、重建 README） |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -22,25 +22,25 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node tag>] [-
|
|||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
||||||
- `/jsc:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）、`git mv` 保留歷史。
|
- `/jsc-generic:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）、`git mv` 保留歷史。
|
||||||
- `/jsc:spec-action-params`：action 參數來源優先序（環境變數 → 經同意新增 `inputs`）、`secrets`／`vars` 一律視為不可用。
|
- `/jsc-generic:spec-action-params`：action 參數來源優先序（環境變數 → 經同意新增 `inputs`）、`secrets`／`vars` 一律視為不可用。
|
||||||
- `/jsc:spec-time-log`：更新時間 Asia/Taipei `yyyy/MM/dd HH:mm:ss`、完成後統一同步時間戳。
|
- `/jsc-generic:spec-time-log`：更新時間 Asia/Taipei `yyyy/MM/dd HH:mm:ss`、完成後統一同步時間戳。
|
||||||
- `/jsc:spec-dockerfile`：Dockerfile 六步流程、多階段建置、固定版號、自我檢查。
|
- `/jsc-generic:spec-dockerfile`：Dockerfile 六步流程、多階段建置、固定版號、自我檢查。
|
||||||
- `/jsc:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc:doc-funcs` 的標準流程。
|
- `/jsc-generic:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc-doc:funcs` 的標準流程。
|
||||||
|
|
||||||
本 skill 特有補充：
|
本 skill 特有補充：
|
||||||
|
|
||||||
- **一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），以及階段 E 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。
|
- **一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），以及階段 E 由 `/jsc-doc:funcs` 自身的「如何實作」詢問。
|
||||||
- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依 `/jsc:spec-action-params` 經使用者同意後為之。
|
- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依 `/jsc-generic:spec-action-params` 經使用者同意後為之。
|
||||||
- **本 skill 只動**：action 專案根目錄內的主程式、主程式依賴鏈的 `.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`、`.dockerignore`，以及階段 E 由 doc-funcs 流程處理的目標。
|
- **本 skill 只動**：action 專案根目錄內的主程式、主程式依賴鏈的 `.js`（搬移到 `src/`）、`package.json`、`action.yml`／`action.yaml`、`entrypoint.sh`、`Dockerfile`、`.dockerignore`，以及階段 E 由 funcs 流程處理的目標。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 參數來源優先序（開發中需要新參數時）
|
## 參數來源優先序（開發中需要新參數時）
|
||||||
|
|
||||||
從零建立（A1a）、主程式 Node 化（階段 B）、產生 `entrypoint.sh`（階段 C）或產生 `Dockerfile`（階段 D）的過程中，若需要新的參數值，一律依 `/jsc:spec-action-params` 的優先序處理：Docker 容器 action 優先取 runner 注入的執行期環境變數（Node 主程式讀 `process.env.GITHUB_*`、`entrypoint.sh` 讀 `$GITHUB_*`；Gitea 亦提供 `GITEA_*` 同義變數，建議讀 `GITHUB_*` 以相容兩邊），取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`（容器內以 `INPUT_<大寫名稱>` 取用）；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端 workflow 傳入（範例見該 spec）。
|
從零建立（A1a）、主程式 Node 化（階段 B）、產生 `entrypoint.sh`（階段 C）或產生 `Dockerfile`（階段 D）的過程中，若需要新的參數值，一律依 `/jsc-generic:spec-action-params` 的優先序處理：Docker 容器 action 優先取 runner 注入的執行期環境變數（Node 主程式讀 `process.env.GITHUB_*`、`entrypoint.sh` 讀 `$GITHUB_*`；Gitea 亦提供 `GITEA_*` 同義變數，建議讀 `GITHUB_*` 以相容兩邊），取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`（容器內以 `INPUT_<大寫名稱>` 取用）；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端 workflow 傳入（範例見該 spec）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -139,7 +139,7 @@ runs:
|
|||||||
|
|
||||||
在 action 根目錄產生（或覆寫）`entrypoint.sh`：**啟動 node 主程式前，先輸出 action 名稱、用途、更新時間**。
|
在 action 根目錄產生（或覆寫）`entrypoint.sh`：**啟動 node 主程式前，先輸出 action 名稱、用途、更新時間**。
|
||||||
|
|
||||||
- **更新時間**依 `/jsc:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 E 完成後會統一同步各處時間戳**（見階段 E）。
|
- **更新時間**依 `/jsc-generic:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 E 完成後會統一同步各處時間戳**（見階段 E）。
|
||||||
- 名稱／用途取自階段 A2 的 `action.yml`。
|
- 名稱／用途取自階段 A2 的 `action.yml`。
|
||||||
- 最後以 `exec node <主程式>`（如 `exec node /action/src/index.js "$@"`）啟動，讓 node 取代 shell 行程，正確傳遞訊號與 exit code；路徑須與階段 D 的 `Dockerfile` 落點一致。
|
- 最後以 `exec node <主程式>`（如 `exec node /action/src/index.js "$@"`）啟動，讓 node 取代 shell 行程，正確傳遞訊號與 exit code；路徑須與階段 D 的 `Dockerfile` 落點一致。
|
||||||
- **若階段 B 裁示「維持非 Node」**：橫幅照常輸出，最後改以 `exec <原直譯器> <主程式>` 啟動（如 `exec python3 /action/src/main.py "$@"`、`exec sh /action/src/main.sh "$@"`）。
|
- **若階段 B 裁示「維持非 Node」**：橫幅照常輸出，最後改以 `exec <原直譯器> <主程式>` 啟動（如 `exec python3 /action/src/main.py "$@"`、`exec sh /action/src/main.sh "$@"`）。
|
||||||
@@ -150,7 +150,7 @@ runs:
|
|||||||
#!/bin/sh
|
#!/bin/sh
|
||||||
set -e
|
set -e
|
||||||
|
|
||||||
# action 啟動橫幅：輸出名稱／用途／更新時間（此檔由 code-action-docker 產生）
|
# action 啟動橫幅：輸出名稱／用途／更新時間（此檔由 action-docker 產生）
|
||||||
echo "================================================"
|
echo "================================================"
|
||||||
echo "Action : <action name>"
|
echo "Action : <action name>"
|
||||||
echo "用途 : <action description>"
|
echo "用途 : <action description>"
|
||||||
@@ -162,7 +162,7 @@ exec node /action/src/index.js "$@"
|
|||||||
```
|
```
|
||||||
|
|
||||||
- 賦予可執行權限：`chmod +x entrypoint.sh`（並於 git 標記為可執行）。
|
- 賦予可執行權限：`chmod +x entrypoint.sh`（並於 git 標記為可執行）。
|
||||||
- 此檔開頭的「用途／更新時間」與每行註解，最終會在階段 E 由 `/jsc:doc-funcs` 的指令檔流程統一補齊／覆寫為標準格式（用途與更新日期同一註解區塊、逐行註解）；本階段先確保**執行期輸出**正確即可。
|
- 此檔開頭的「用途／更新時間」與每行註解，最終會在階段 E 由 `/jsc-doc:funcs` 的指令檔流程統一補齊／覆寫為標準格式（用途與更新日期同一註解區塊、逐行註解）；本階段先確保**執行期輸出**正確即可。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -190,7 +190,7 @@ exec node /action/src/index.js "$@"
|
|||||||
5. **縮小映像檔**：多階段建置，runtime 改用 slim 基底，只 `COPY --from=build` 帶入主程式執行**真正需要**的產物——有 build 產物時帶入 `dist/` 與 production `node_modules`（`npm prune --omit=dev` 或重裝 production 相依），純 JS 無 build 時帶入 `src/` 與 production `node_modules`；若 D0 判定 runtime 需要某些 OS 執行檔，於 runtime 階段一併安裝（slim 基底可能不含）。不要把 build 階段的 dev 相依與快取帶進最終映像；**`COPY --from=build` 必須逐項明列路徑，不得整包 `COPY --from=build /action /action`**（整包搬等於沒有縮小）。
|
5. **縮小映像檔**：多階段建置，runtime 改用 slim 基底，只 `COPY --from=build` 帶入主程式執行**真正需要**的產物——有 build 產物時帶入 `dist/` 與 production `node_modules`（`npm prune --omit=dev` 或重裝 production 相依），純 JS 無 build 時帶入 `src/` 與 production `node_modules`；若 D0 判定 runtime 需要某些 OS 執行檔，於 runtime 階段一併安裝（slim 基底可能不含）。不要把 build 階段的 dev 相依與快取帶進最終映像；**`COPY --from=build` 必須逐項明列路徑，不得整包 `COPY --from=build /action /action`**（整包搬等於沒有縮小）。
|
||||||
6. **設定入口**：`ENTRYPOINT` 指向 `entrypoint.sh`，其內 `node` 路徑為 D0 的入口檔。
|
6. **設定入口**：`ENTRYPOINT` 指向 `entrypoint.sh`，其內 `node` 路徑為 D0 的入口檔。
|
||||||
|
|
||||||
base image 版本依 `/jsc:spec-dockerfile`（固定 major tag、不用 `latest`）：**預設使用產生當下的最新 LTS major 固定 tag**（如 build 基底 `node:22`、runtime 基底 `node:22-slim`），可查詢 Docker Hub（`https://hub.docker.com/_/node`）確認當前 LTS 版號；帶 `--node-version <tag>` 時改用 `node:<tag>` 與 `node:<tag>-slim`。
|
base image 版本依 `/jsc-generic:spec-dockerfile`（固定 major tag、不用 `latest`）：**預設使用產生當下的最新 LTS major 固定 tag**（如 build 基底 `node:22`、runtime 基底 `node:22-slim`），可查詢 Docker Hub（`https://hub.docker.com/_/node`）確認當前 LTS 版號；帶 `--node-version <tag>` 時改用 `node:<tag>` 與 `node:<tag>-slim`。
|
||||||
|
|
||||||
下列為**最簡基準骨架**（純 JS、無 build、無 OS 相依的情況）；實際內容須依 D0 盤點調整，第 4 步建置、第 2／5 步 OS 套件等視主程式需要增刪：
|
下列為**最簡基準骨架**（純 JS、無 build、無 OS 相依的情況）；實際內容須依 D0 盤點調整，第 4 步建置、第 2／5 步 OS 套件等視主程式需要增刪：
|
||||||
|
|
||||||
@@ -231,15 +231,15 @@ ENTRYPOINT ["/action/entrypoint.sh"]
|
|||||||
|
|
||||||
- **依主程式實作**：上面只是基準骨架。若主程式是 TypeScript／需打包，第 4 步要加 `npm run build`、第 5 步只帶 `dist/` 與 production 相依；若主程式會 spawn 外部執行檔或用原生模組，第 2／5 步要補對應 OS 套件；用不到的步驟內容不要硬塞。
|
- **依主程式實作**：上面只是基準骨架。若主程式是 TypeScript／需打包，第 4 步要加 `npm run build`、第 5 步只帶 `dist/` 與 production 相依；若主程式會 spawn 外部執行檔或用原生模組，第 2／5 步要補對應 OS 套件；用不到的步驟內容不要硬塞。
|
||||||
- **若階段 B 裁示「維持非 Node」**：base image 改用對應語言官方映像（如 `python:3-slim`），第 2 步改安裝該生態相依（如 `pip install -r requirements.txt`），其餘六步結構不變；`ENTRYPOINT` 仍指向 `entrypoint.sh`（其內 `exec` 原直譯器，見階段 C）。
|
- **若階段 B 裁示「維持非 Node」**：base image 改用對應語言官方映像（如 `python:3-slim`），第 2 步改安裝該生態相依（如 `pip install -r requirements.txt`），其餘六步結構不變；`ENTRYPOINT` 仍指向 `entrypoint.sh`（其內 `exec` 原直譯器，見階段 C）。
|
||||||
- **版號對齊**：依 `/jsc:spec-dockerfile`（runtime 與 build 版號一致、以獨立 runtime ARG 帶入不用 `${VERSION}-slim` 組裝、`-alpine`／`-slim` 變體沿用同一 tag、使用者要求 `latest` 時 runtime 用 `node:slim`）。
|
- **版號對齊**：依 `/jsc-generic:spec-dockerfile`（runtime 與 build 版號一致、以獨立 runtime ARG 帶入不用 `${VERSION}-slim` 組裝、`-alpine`／`-slim` 變體沿用同一 tag、使用者要求 `latest` 時 runtime 用 `node:slim`）。
|
||||||
- **自我檢查**：`entrypoint.sh` 的 `node <主程式>` 路徑（如 `/action/src/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式；`action.yml` 的 `runs.entrypoint` 若存在，必須是**絕對路徑**且與 `Dockerfile` 落點一致（預設不設，讓 Dockerfile 的 `ENTRYPOINT` 生效）。
|
- **自我檢查**：`entrypoint.sh` 的 `node <主程式>` 路徑（如 `/action/src/index.js`）需與 `Dockerfile` 的 `WORKDIR`／`COPY` 落點一致，避免容器啟動時找不到主程式；`action.yml` 的 `runs.entrypoint` 若存在，必須是**絕對路徑**且與 `Dockerfile` 落點一致（預設不設，讓 Dockerfile 的 `ENTRYPOINT` 生效）。
|
||||||
- 此檔的用途／更新日期註解與逐行註解，同樣於階段 E 由 doc-funcs 指令檔流程統一補齊。
|
- 此檔的用途／更新日期註解與逐行註解，同樣於階段 E 由 funcs 指令檔流程統一補齊。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 階段 E：完整執行 /jsc:doc-funcs 處理流程
|
## 階段 E：完整執行 /jsc-doc:funcs 處理流程
|
||||||
|
|
||||||
容器化與 Node 化完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次新增／變更的 `entrypoint.sh`、`Dockerfile` 與 `src/` 內 Node 主程式都會被涵蓋）。完成後依該 spec **統一時間戳**：回頭同步 `entrypoint.sh` 橫幅輸出與註解區塊、`Dockerfile` 註解區塊與 README 的更新時間，確保各處一致。
|
容器化與 Node 化完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc-generic:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc-doc:funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次新增／變更的 `entrypoint.sh`、`Dockerfile` 與 `src/` 內 Node 主程式都會被涵蓋）。完成後依該 spec **統一時間戳**：回頭同步 `entrypoint.sh` 橫幅輸出與註解區塊、`Dockerfile` 註解區塊與 README 的更新時間，確保各處一致。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -250,7 +250,7 @@ ENTRYPOINT ["/action/entrypoint.sh"]
|
|||||||
- **階段 A**：action 根目錄、action 名稱／用途、原主程式檔與語言、是否為 Node；若走 A1a 從零建立，列出問答收集結果（名稱／輸入輸出／目標）。
|
- **階段 A**：action 根目錄、action 名稱／用途、原主程式檔與語言、是否為 Node；若走 A1a 從零建立，列出問答收集結果（名稱／輸入輸出／目標）。
|
||||||
- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。
|
- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。
|
||||||
- **階段 C／D**：`entrypoint.sh` 的輸出內容（名稱／用途／更新時間）與啟動的 node 主程式、`Dockerfile` 採用的 node 版本與 `ENTRYPOINT`。
|
- **階段 C／D**：`entrypoint.sh` 的輸出內容（名稱／用途／更新時間）與啟動的 node 主程式、`Dockerfile` 採用的 node 版本與 `ENTRYPOINT`。
|
||||||
- **階段 E**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
- **階段 E**：funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
||||||
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `entrypoint.sh` 有可執行權限、容器能正確啟動。
|
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `entrypoint.sh` 有可執行權限、容器能正確啟動。
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -261,6 +261,6 @@ ENTRYPOINT ["/action/entrypoint.sh"]
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-action-docker`，或 `/jsc:code-action-docker --action-dir ~/work/my-action --node-version 22` |
|
| Claude Code / Antigravity | `/jsc-code:action-docker`，或 `/jsc-code:action-docker --action-dir ~/work/my-action --node-version 22` |
|
||||||
| Codex | `$code-action-docker`，或 `$code-action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單 |
|
| Codex | `$action-docker`，或 `$action-docker --action-dir ~/work/my-action`，或用 `/skills` 選單 |
|
||||||
| OpenCode | 描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 LTS node 版本的 Dockerfile，最後跑 doc-funcs 補文件並重建 README」）自動觸發 |
|
| OpenCode | 描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，產生會先輸出 action 名稱／用途／更新時間再啟動 node 的 entrypoint.sh、用最新 LTS node 版本的 Dockerfile，最後跑 funcs 補文件並重建 README」）自動觸發 |
|
||||||
@@ -1,12 +1,12 @@
|
|||||||
---
|
---
|
||||||
name: code-action-node
|
name: action-node
|
||||||
description: 將 Gitea／GitHub「Node（JavaScript）action」專案標準化（目錄沒有 action manifest 時可問答式從零建立），並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且主程式及其依賴鏈的 `.js` 檔集中到 `src/` 資料夾（工具設定檔與測試目錄不搬）；(2) 對齊 `action.yml` 為 node action（`runs.using` 設為 `node24`、指定 `runs.main`，`outputs` 只留 `description` 不設 `value`，`inputs` 由 runner 自動注入 `INPUT_*`），並在主程式入口最前面輸出 action 名稱／用途／更新時間橫幅；(3) 處理相依打包——零相依則 `main` 直接指向 `src/index.js`，有相依則以 `@vercel/ncc` 打包成 `dist/index.js`、`main` 改指 `dist/index.js` 並將 `dist/` commit 進 repo（runner 不會自動 `npm install`）；(4) 開發中需要新參數時優先取用 runner 注入的 `GITHUB_*`（Gitea 亦有 `GITEA_*`）執行期環境變數，無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` 一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(5) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 node／JavaScript action、從零建立／產生一個 node action、action 主程式 node 化、把 js 收進 src、用 ncc 打包 action、處理 node action 相依或參數來源，或提到 code-action-node 時觸發。不適用於：Docker 容器 action（用 code-action-docker）、composite action（用 code-action-composite）、只整理既有 Dockerfile（用 code-image）、或不需 action 化／文件化的一般 repo。
|
description: 將 Gitea／GitHub「Node（JavaScript）action」專案標準化（目錄沒有 action manifest 時可問答式從零建立），並串接文件化流程：(1) 檢查 action 主程式是否為 Node，否則保守改寫為 Node，且主程式及其依賴鏈的 `.js` 檔集中到 `src/` 資料夾（工具設定檔與測試目錄不搬）；(2) 對齊 `action.yml` 為 node action（`runs.using` 設為 `node24`、指定 `runs.main`，`outputs` 只留 `description` 不設 `value`，`inputs` 由 runner 自動注入 `INPUT_*`），並在主程式入口最前面輸出 action 名稱／用途／更新時間橫幅；(3) 處理相依打包——零相依則 `main` 直接指向 `src/index.js`，有相依則以 `@vercel/ncc` 打包成 `dist/index.js`、`main` 改指 `dist/index.js` 並將 `dist/` commit 進 repo（runner 不會自動 `npm install`）；(4) 開發中需要新參數時優先取用 runner 注入的 `GITHUB_*`（Gitea 亦有 `GITEA_*`）執行期環境變數，無法取得才詢問使用者是否新增 `inputs`（`secrets`／`vars` 一律視為不可用，需要時宣告為 `inputs` 由呼叫端 workflow 傳入）；(5) 最後完整執行 `/jsc-doc:funcs` 處理流程（function 文件、指令檔逐行註解、重建 README）。當使用者說把 action 改成 node／JavaScript action、從零建立／產生一個 node action、action 主程式 node 化、把 js 收進 src、用 ncc 打包 action、處理 node action 相依或參數來源，或提到 action-node 時觸發。不適用於：Docker 容器 action（用 action-docker）、composite action（用 action-composite）、只整理既有 Dockerfile（用 image）、或不需 action 化／文件化的一般 repo。
|
||||||
argument-hint: "[--action-dir <action 根目錄>] [--node-version <node runtime，如 node24>] [--main <主程式檔>]"
|
argument-hint: "[--action-dir <action 根目錄>] [--node-version <node runtime，如 node24>] [--main <主程式檔>]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-action-node — Node（JavaScript）action 標準化＋文件化
|
# action-node — Node（JavaScript）action 標準化＋文件化
|
||||||
|
|
||||||
五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將主程式依賴鏈的 `.js` 收進 `src/`**，接著**對齊 `action.yml` 為 node action 並在主程式入口最前面注入輸出名稱／用途／更新時間的啟動橫幅**，然後**處理相依打包**（零相依直接跑 `src/`，有相依以 `@vercel/ncc` 打包成 `dist/` 並 commit），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。產出的 node action 由 **runner 內建的 Node runtime 直接執行 `runs.main`**（不需 Docker、啟動比 docker action 快）。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 `action.yml` 與 Node 主程式骨架，再進入後續階段。
|
五階段 skill：先做**前置設定與偵測**（找出 action 專案、讀取名稱／用途、判斷主程式語言），再把**主程式 Node 化並將主程式依賴鏈的 `.js` 收進 `src/`**，接著**對齊 `action.yml` 為 node action 並在主程式入口最前面注入輸出名稱／用途／更新時間的啟動橫幅**，然後**處理相依打包**（零相依直接跑 `src/`，有相依以 `@vercel/ncc` 打包成 `dist/` 並 commit），最後**完整執行 `/jsc-doc:funcs` 處理流程**替整個專案補文件並重建 README。產出的 node action 由 **runner 內建的 Node runtime 直接執行 `runs.main`**（不需 Docker、啟動比 docker action 快）。各階段開發中需要新參數時，一律套用下方「**參數來源優先序**」規則。目錄沒有 action manifest 時，先走 A1a 問答式「**從零建立**」分支產生 `action.yml` 與 Node 主程式骨架，再進入後續階段。
|
||||||
|
|
||||||
| 階段 | 動作 |
|
| 階段 | 動作 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
@@ -14,7 +14,7 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node runtime
|
|||||||
| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 主程式依賴鏈的 `.js` 集中到 `src/`，更新所有引用、`package.json`、`action.yml` |
|
| B. 主程式 Node 化 | 主程式非 Node 則**保守改寫**為 Node（高風險，先確認）→ 主程式依賴鏈的 `.js` 集中到 `src/`，更新所有引用、`package.json`、`action.yml` |
|
||||||
| C. 對齊 action.yml + 啟動橫幅 | `runs` 對齊 node action（`using: node24` + `main`）、`outputs` 去除 `value`、`inputs` 契約保留；在主程式入口最前面輸出 action **名稱／用途／更新時間** |
|
| C. 對齊 action.yml + 啟動橫幅 | `runs` 對齊 node action（`using: node24` + `main`）、`outputs` 去除 `value`、`inputs` 契約保留；在主程式入口最前面輸出 action **名稱／用途／更新時間** |
|
||||||
| D. 相依處理與打包 | 零相依 → `main` 指 `src/index.js`；有相依 → `ncc build` 成 `dist/index.js`、`main` 改指 `dist/index.js`、`dist/` commit 進 repo（runner 不會 `npm install`） |
|
| D. 相依處理與打包 | 零相依 → `main` 指 `src/index.js`；有相依 → `ncc build` 成 `dist/index.js`、`main` 改指 `dist/index.js`、`dist/` commit 進 repo（runner 不會 `npm install`） |
|
||||||
| E. 串接 doc-funcs | 對整個 action 專案完整執行 `/jsc:doc-funcs` 流程（function 文件、指令檔逐行註解、重建 README） |
|
| E. 串接 funcs | 對整個 action 專案完整執行 `/jsc-doc:funcs` 流程（function 文件、指令檔逐行註解、重建 README） |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -22,18 +22,18 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node runtime
|
|||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
||||||
- `/jsc:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）、`git mv` 保留歷史。
|
- `/jsc-generic:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）、`git mv` 保留歷史。
|
||||||
- `/jsc:spec-action-params`：action 參數來源優先序（環境變數 → 經同意新增 `inputs`）、`secrets`／`vars` 一律視為不可用。
|
- `/jsc-generic:spec-action-params`：action 參數來源優先序（環境變數 → 經同意新增 `inputs`）、`secrets`／`vars` 一律視為不可用。
|
||||||
- `/jsc:spec-time-log`：更新時間 Asia/Taipei `yyyy/MM/dd HH:mm:ss`、完成後統一同步時間戳。
|
- `/jsc-generic:spec-time-log`：更新時間 Asia/Taipei `yyyy/MM/dd HH:mm:ss`、完成後統一同步時間戳。
|
||||||
- `/jsc:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc:doc-funcs` 的標準流程。
|
- `/jsc-generic:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc-doc:funcs` 的標準流程。
|
||||||
|
|
||||||
本 skill 特有補充：
|
本 skill 特有補充：
|
||||||
|
|
||||||
- **一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），階段 D「新增 `@vercel/ncc` 等 build 相依」時（依 `/jsc:spec-action-params` 經同意），以及階段 E 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。
|
- **一定會中斷詢問的點**：階段 B 主程式「非 Node 需改寫」時（破壞性，須先確認），階段 D「新增 `@vercel/ncc` 等 build 相依」時（依 `/jsc-generic:spec-action-params` 經同意），以及階段 E 由 `/jsc-doc:funcs` 自身的「如何實作」詢問。
|
||||||
- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依 `/jsc:spec-action-params` 經使用者同意後為之。
|
- **保留行為**：Node 化只「翻譯」既有邏輯，不得擅自改變對外行為、輸入輸出契約或副作用；任何無法可靠等價推論的改動一律不做，並以註解或回報標註「需人工確認」。新增 `input` 僅限依 `/jsc-generic:spec-action-params` 經使用者同意後為之。
|
||||||
- **本 skill 只動**：action 專案根目錄內的主程式、主程式依賴鏈的 `.js`（搬移到 `src/`）、`package.json`（含 `scripts.build`）、`action.yml`／`action.yaml`、打包產物 `dist/`、`.gitignore`（確保 `dist/` 不被忽略），以及階段 E 由 doc-funcs 流程處理的目標。**不產生** `Dockerfile`／`entrypoint.sh`（那是 code-action-docker 的範疇）。
|
- **本 skill 只動**：action 專案根目錄內的主程式、主程式依賴鏈的 `.js`（搬移到 `src/`）、`package.json`（含 `scripts.build`）、`action.yml`／`action.yaml`、打包產物 `dist/`、`.gitignore`（確保 `dist/` 不被忽略），以及階段 E 由 funcs 流程處理的目標。**不產生** `Dockerfile`／`entrypoint.sh`（那是 action-docker 的範疇）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -41,9 +41,9 @@ argument-hint: "[--action-dir <action 根目錄>] [--node-version <node runtime
|
|||||||
|
|
||||||
| 型態 | `runs.using` | 執行方式 | 對應 skill |
|
| 型態 | `runs.using` | 執行方式 | 對應 skill |
|
||||||
| --- | --- | --- | --- |
|
| --- | --- | --- | --- |
|
||||||
| **node（本 skill）** | `node24`／`node20`… | runner 內建 Node 直接跑 `main` 指定的 `.js`；**不會 `npm install`** | `code-action-node` |
|
| **node（本 skill）** | `node24`／`node20`… | runner 內建 Node 直接跑 `main` 指定的 `.js`；**不會 `npm install`** | `action-node` |
|
||||||
| composite | `composite` | 依序執行 `steps`（純 YAML 組合） | `code-action-composite` |
|
| composite | `composite` | 依序執行 `steps`（純 YAML 組合） | `action-composite` |
|
||||||
| docker | `docker` | 建 image、於容器內執行（可 `npm ci`） | `code-action-docker` |
|
| docker | `docker` | 建 image、於容器內執行（可 `npm ci`） | `action-docker` |
|
||||||
|
|
||||||
node action 相對 docker／composite 的**關鍵差異**（全程據此處理）：
|
node action 相對 docker／composite 的**關鍵差異**（全程據此處理）：
|
||||||
|
|
||||||
@@ -59,7 +59,7 @@ node action 相對 docker／composite 的**關鍵差異**（全程據此處理
|
|||||||
|
|
||||||
## 參數來源優先序（開發中需要新參數時）
|
## 參數來源優先序（開發中需要新參數時）
|
||||||
|
|
||||||
從零建立（A1a）、主程式 Node 化（階段 B）、對齊 `action.yml`（階段 C）或打包（階段 D）的過程中，若需要新的參數值，一律依 `/jsc:spec-action-params` 的優先序處理：node action 主程式優先取 runner 注入的執行期環境變數（`process.env.GITHUB_*`；Gitea 亦提供 `GITEA_*` 同義變數，建議讀 `GITHUB_*` 以相容兩邊），既有 `inputs` 以 `process.env.INPUT_<大寫名稱>`（或 `core.getInput`）取用，取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`（由呼叫端 workflow 以 `with:` 傳入）；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端傳入（範例見該 spec）。
|
從零建立（A1a）、主程式 Node 化（階段 B）、對齊 `action.yml`（階段 C）或打包（階段 D）的過程中，若需要新的參數值，一律依 `/jsc-generic:spec-action-params` 的優先序處理：node action 主程式優先取 runner 注入的執行期環境變數（`process.env.GITHUB_*`；Gitea 亦提供 `GITEA_*` 同義變數，建議讀 `GITHUB_*` 以相容兩邊），既有 `inputs` 以 `process.env.INPUT_<大寫名稱>`（或 `core.getInput`）取用，取不到才以 `AskUserQuestion` 經使用者同意新增 `inputs`（由呼叫端 workflow 以 `with:` 傳入）；`secrets`／`vars` 一律視為不可用，需要時宣告為 `input` 由呼叫端傳入（範例見該 spec）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -108,7 +108,7 @@ node action 相對 docker／composite 的**關鍵差異**（全程據此處理
|
|||||||
|
|
||||||
1. 帶 `--main <主程式檔>` → 直接採用。
|
1. 帶 `--main <主程式檔>` → 直接採用。
|
||||||
2. `action.yml` 為 JS action（`runs.using: node*`）→ 取 `runs.main`。
|
2. `action.yml` 為 JS action（`runs.using: node*`）→ 取 `runs.main`。
|
||||||
3. `action.yml` 為 docker action（`runs.using: docker`）→ 看 `runs.entrypoint`／`Dockerfile` 的 `ENTRYPOINT`／`CMD` 推主程式（並提醒：轉為 node action 會**移除容器化**，若原本刻意用 docker，宜改用 `code-action-docker`）。
|
3. `action.yml` 為 docker action（`runs.using: docker`）→ 看 `runs.entrypoint`／`Dockerfile` 的 `ENTRYPOINT`／`CMD` 推主程式（並提醒：轉為 node action 會**移除容器化**，若原本刻意用 docker，宜改用 `action-docker`）。
|
||||||
4. `action.yml` 為 composite（`runs.using: composite`）→ 從 `steps` 內實際執行的指令推主程式（提醒：composite 轉 node 屬破壞性改寫）。
|
4. `action.yml` 為 composite（`runs.using: composite`）→ 從 `steps` 內實際執行的指令推主程式（提醒：composite 轉 node 屬破壞性改寫）。
|
||||||
5. 以上皆無 → 依專案檔與副檔名分布推斷（`package.json` 的 `main`／`bin`、`index.js`、`*.sh`、`*.py` 等）。
|
5. 以上皆無 → 依專案檔與副檔名分布推斷（`package.json` 的 `main`／`bin`、`index.js`、`*.sh`、`*.py` 等）。
|
||||||
|
|
||||||
@@ -121,7 +121,7 @@ node action 相對 docker／composite 的**關鍵差異**（全程據此處理
|
|||||||
### B1. 主程式 Node 化
|
### B1. 主程式 Node 化
|
||||||
|
|
||||||
- **已是 Node** → 確認入口檔，不改寫邏輯，直接進 B2。
|
- **已是 Node** → 確認入口檔，不改寫邏輯，直接進 B2。
|
||||||
- **非 Node（shell／python／其他）** → 這是**破壞性高風險決策**：先以 `AskUserQuestion` 向使用者確認是否改寫為 Node，選項至少含「改寫為 Node」「改用 code-action-docker（維持原語言容器化）」「其他」。經確認後才改寫：
|
- **非 Node（shell／python／其他）** → 這是**破壞性高風險決策**：先以 `AskUserQuestion` 向使用者確認是否改寫為 Node，選項至少含「改寫為 Node」「改用 action-docker（維持原語言容器化）」「其他」。經確認後才改寫：
|
||||||
- 逐段把原主程式邏輯**保守翻譯**為 Node（建議 `src/index.js`）；保留對外行為、輸入（環境變數／`INPUT_*`／args）與輸出（`$GITHUB_OUTPUT`／stdout／exit code／檔案副作用）契約。
|
- 逐段把原主程式邏輯**保守翻譯**為 Node（建議 `src/index.js`）；保留對外行為、輸入（環境變數／`INPUT_*`／args）與輸出（`$GITHUB_OUTPUT`／stdout／exit code／檔案副作用）契約。
|
||||||
- 外部指令呼叫以 `child_process`（`execFileSync`／`spawnSync`）對應；檔案操作以 `fs`；環境變數以 `process.env`。
|
- 外部指令呼叫以 `child_process`（`execFileSync`／`spawnSync`）對應；檔案操作以 `fs`；環境變數以 `process.env`。
|
||||||
- 任何無法可靠等價翻譯處，**不臆測**：以 `// 需人工確認：...` 標註並回報。
|
- 任何無法可靠等價翻譯處，**不臆測**：以 `// 需人工確認：...` 標註並回報。
|
||||||
@@ -152,7 +152,7 @@ runs:
|
|||||||
main: 'src/index.js' # 有相依打包後於階段 D 改為 'dist/index.js'
|
main: 'src/index.js' # 有相依打包後於階段 D 改為 'dist/index.js'
|
||||||
```
|
```
|
||||||
|
|
||||||
- **`using` 版本**依 `/jsc:spec-time-log` 之外另遵循版本規則：**預設 `node24`**（現行最新、本生態範本採用），帶 `--node-version` 時改用指定值。`node24` 需較新的 act runner；runner 太舊會報 `The runs.using key in action.yml must be one of: [composite docker node12 node16 node20 go], got node24`——此時**升級 act runner**，或（回報後）暫時退回 `node20`。**不用**沒有意義的 `latest`。
|
- **`using` 版本**依 `/jsc-generic:spec-time-log` 之外另遵循版本規則：**預設 `node24`**（現行最新、本生態範本採用），帶 `--node-version` 時改用指定值。`node24` 需較新的 act runner；runner 太舊會報 `The runs.using key in action.yml must be one of: [composite docker node12 node16 node20 go], got node24`——此時**升級 act runner**，或（回報後）暫時退回 `node20`。**不用**沒有意義的 `latest`。
|
||||||
- **`outputs` 去 `value`**：node action 的 `outputs.<name>` 只保留 `description`，**移除**任何 `value: ${{ steps.* }}`（那是 composite 寫法）；實際值於執行時由程式寫入 `$GITHUB_OUTPUT`。
|
- **`outputs` 去 `value`**：node action 的 `outputs.<name>` 只保留 `description`，**移除**任何 `value: ${{ steps.* }}`（那是 composite 寫法）；實際值於執行時由程式寫入 `$GITHUB_OUTPUT`。
|
||||||
- **`inputs` 契約保留**：不更動既有 `inputs` 名稱／`required`／`default`；主程式以 `process.env.INPUT_<大寫名稱>`（或 `core.getInput`）取用，runner 會自動注入，**不需**像 composite 手動映射 `env:`。
|
- **`inputs` 契約保留**：不更動既有 `inputs` 名稱／`required`／`default`；主程式以 `process.env.INPUT_<大寫名稱>`（或 `core.getInput`）取用，runner 會自動注入，**不需**像 composite 手動映射 `env:`。
|
||||||
- 原本是 **docker／composite** action 改為 node 時，一併移除只服務原型態的欄位（`image`／`entrypoint`／`steps`），並在回報標示型態已變更；無法可靠等價轉換處以 `# 需人工確認` 標註、不臆測。
|
- 原本是 **docker／composite** action 改為 node 時，一併移除只服務原型態的欄位（`image`／`entrypoint`／`steps`），並在回報標示型態已變更；無法可靠等價轉換處以 `# 需人工確認` 標註、不臆測。
|
||||||
@@ -162,14 +162,14 @@ runs:
|
|||||||
|
|
||||||
node action 沒有 `entrypoint.sh`，橫幅改由**主程式 JS 最前面輸出**。在 `src/index.js`（或階段 B 決定的入口）最上方，於任何其他邏輯**之前**插入（或更新）橫幅輸出：
|
node action 沒有 `entrypoint.sh`，橫幅改由**主程式 JS 最前面輸出**。在 `src/index.js`（或階段 B 決定的入口）最上方，於任何其他邏輯**之前**插入（或更新）橫幅輸出：
|
||||||
|
|
||||||
- **更新時間**依 `/jsc:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 E 完成後會統一同步各處時間戳**（見階段 E）。
|
- **更新時間**依 `/jsc-generic:spec-time-log`（Asia/Taipei、固定 `yyyy/MM/dd HH:mm:ss`、寫成檔內固定字串）。本階段先寫入暫定時間戳，**階段 E 完成後會統一同步各處時間戳**（見階段 E）。
|
||||||
- 名稱／用途取自階段 A2 的 `action.yml`（缺漏時以「（未提供）」標示）。
|
- 名稱／用途取自階段 A2 的 `action.yml`（缺漏時以「（未提供）」標示）。
|
||||||
- 若已存在本 skill 先前插入的橫幅（依可辨識註解標記），則**更新**其內容與時間戳，不重複插入。
|
- 若已存在本 skill 先前插入的橫幅（依可辨識註解標記），則**更新**其內容與時間戳，不重複插入。
|
||||||
|
|
||||||
範例（純 `console.log`、零相依；用 `@actions/core` 時可改 `core.info`）：
|
範例（純 `console.log`、零相依；用 `@actions/core` 時可改 `core.info`）：
|
||||||
|
|
||||||
```js
|
```js
|
||||||
// action 啟動橫幅：輸出名稱／用途／更新時間（此區塊由 code-action-node 維護）
|
// action 啟動橫幅：輸出名稱／用途／更新時間（此區塊由 action-node 維護）
|
||||||
console.log('================================================');
|
console.log('================================================');
|
||||||
console.log('Action : <action name>');
|
console.log('Action : <action name>');
|
||||||
console.log('用途 : <action description>');
|
console.log('用途 : <action description>');
|
||||||
@@ -178,7 +178,7 @@ console.log('================================================');
|
|||||||
```
|
```
|
||||||
|
|
||||||
- 橫幅只做輸出，**不得**改變既有主邏輯的執行順序或副作用。
|
- 橫幅只做輸出，**不得**改變既有主邏輯的執行順序或副作用。
|
||||||
- 此區塊的「用途／更新時間」與檔內註解，最終會在階段 E 由 `/jsc:doc-funcs` 的指令檔／function 流程統一補齊／覆寫為標準格式；本階段先確保**執行期輸出**正確即可。
|
- 此區塊的「用途／更新時間」與檔內註解，最終會在階段 E 由 `/jsc-doc:funcs` 的指令檔／function 流程統一補齊／覆寫為標準格式；本階段先確保**執行期輸出**正確即可。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -202,7 +202,7 @@ node action 的 runner **不會自動 `npm install`**，因此相依必須隨 re
|
|||||||
|
|
||||||
打包能把原始碼與相依編成單一檔，避免 commit 龐大的 `node_modules`：
|
打包能把原始碼與相依編成單一檔，避免 commit 龐大的 `node_modules`：
|
||||||
|
|
||||||
1. 新增 build 相依（依 `/jsc:spec-action-params`／本 skill「一定會中斷詢問的點」，屬新增相依，先向使用者確認）：`npm i -D @vercel/ncc`，並確保 `package.json` 有：
|
1. 新增 build 相依（依 `/jsc-generic:spec-action-params`／本 skill「一定會中斷詢問的點」，屬新增相依，先向使用者確認）：`npm i -D @vercel/ncc`，並確保 `package.json` 有：
|
||||||
```json
|
```json
|
||||||
"scripts": { "build": "ncc build src/index.js -o dist" }
|
"scripts": { "build": "ncc build src/index.js -o dist" }
|
||||||
```
|
```
|
||||||
@@ -221,9 +221,9 @@ node action 的 runner **不會自動 `npm install`**，因此相依必須隨 re
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 階段 E：完整執行 /jsc:doc-funcs 處理流程
|
## 階段 E：完整執行 /jsc-doc:funcs 處理流程
|
||||||
|
|
||||||
標準化與打包完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc:doc-funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次新增／變更的 `src/` 內 Node 主程式、`action.yml`、`package.json` 都會被涵蓋）。完成後依該 spec **統一時間戳**：回頭同步主程式橫幅輸出與註解區塊、`action.yml` 開頭註解區塊與 README 的更新時間，確保各處一致。
|
標準化與打包完成後，以階段 A1 的 action 根目錄為目標，依 `/jsc-generic:spec-doc-funcs-handoff` 對**整個 action 專案**完整執行 `/jsc-doc:funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次新增／變更的 `src/` 內 Node 主程式、`action.yml`、`package.json` 都會被涵蓋）。完成後依該 spec **統一時間戳**：回頭同步主程式橫幅輸出與註解區塊、`action.yml` 開頭註解區塊與 README 的更新時間，確保各處一致。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -235,7 +235,7 @@ node action 的 runner **不會自動 `npm install`**，因此相依必須隨 re
|
|||||||
- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。
|
- **階段 B**：是否改寫主程式（及改寫摘要與「需人工確認」清單）、搬入 `src/` 的 `.js` 清單、已更新的引用（`package.json`／`action.yml`／路徑）；依「參數來源優先序」新增的 `inputs` 清單與呼叫端傳入寫法（若有）。
|
||||||
- **階段 C**：對齊後的 `runs`（`using`／`main`）、`outputs` 是否已去除 `value`、`inputs` 契約保留情形、橫幅輸出內容（名稱／用途／更新時間）與插入位置。
|
- **階段 C**：對齊後的 `runs`（`using`／`main`）、`outputs` 是否已去除 `value`、`inputs` 契約保留情形、橫幅輸出內容（名稱／用途／更新時間）與插入位置。
|
||||||
- **階段 D**：相依判定（零相依／打包）、是否新增 `@vercel/ncc`、`runs.main` 最終指向（`src/index.js` 或 `dist/index.js`）、`dist/` 是否已 commit。
|
- **階段 D**：相依判定（零相依／打包）、是否新增 `@vercel/ncc`、`runs.main` 最終指向（`src/index.js` 或 `dist/index.js`）、`dist/` 是否已 commit。
|
||||||
- **階段 E**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
- **階段 E**：funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
||||||
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `runs.main` 檔案存在、（打包時）`dist/` 已提交、目標 runner 支援指定的 node 版本。
|
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `runs.main` 檔案存在、（打包時）`dist/` 已提交、目標 runner 支援指定的 node 版本。
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -246,6 +246,6 @@ node action 的 runner **不會自動 `npm install`**，因此相依必須隨 re
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-action-node`，或 `/jsc:code-action-node --action-dir ~/work/my-action --node-version node24` |
|
| Claude Code / Antigravity | `/jsc-code:action-node`，或 `/jsc-code:action-node --action-dir ~/work/my-action --node-version node24` |
|
||||||
| Codex | `$code-action-node`，或 `$code-action-node --action-dir ~/work/my-action`，或用 `/skills` 選單 |
|
| Codex | `$action-node`，或 `$action-node --action-dir ~/work/my-action`，或用 `/skills` 選單 |
|
||||||
| OpenCode | 描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，對齊 action.yml 為 node action、在主程式最前面輸出 action 名稱／用途／更新時間，有相依就用 ncc 打包成 dist 並 commit，最後跑 doc-funcs 補文件並重建 README」）自動觸發 |
|
| OpenCode | 描述需求（如「把這個 action 主程式改成 node、主程式相關 js 收進 src/，對齊 action.yml 為 node action、在主程式最前面輸出 action 名稱／用途／更新時間，有相依就用 ncc 打包成 dist 並 commit，最後跑 funcs 補文件並重建 README」）自動觸發 |
|
||||||
@@ -1,18 +1,18 @@
|
|||||||
---
|
---
|
||||||
name: code-image
|
name: image
|
||||||
description: 把專案的 `Dockerfile` 整理成固定六步流程並串接文件化流程：(1) 找出專案根目錄與目標 `Dockerfile`、判斷語言／生態與既有建置方式；(2) 在保留建置行為的前提下，把 `Dockerfile` 重整為 **參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口** 六步流程（以多階段建置縮小最終映像，可調參數集中於檔首 `ARG`，相依描述先 `COPY` 以利 layer 快取）；(3) 最後完整執行 `/jsc:doc-funcs` 處理流程（function 文件、`Dockerfile` 等指令檔逐行註解、重建 README）。當使用者說整理／重構 Dockerfile、把 Dockerfile 排成參數處理→安裝→複製→執行→縮小→入口六步、優化映像檔分層／多階段建置、縮小 image，或提到 code-image 時觸發。不適用於：Gitea／GitHub action 容器化（用 code-action-docker）、composite action（用 code-action-composite）、或專案內沒有也不需要 Dockerfile 的情況。
|
description: 把專案的 `Dockerfile` 整理成固定六步流程並串接文件化流程：(1) 找出專案根目錄與目標 `Dockerfile`、判斷語言／生態與既有建置方式；(2) 在保留建置行為的前提下，把 `Dockerfile` 重整為 **參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口** 六步流程（以多階段建置縮小最終映像，可調參數集中於檔首 `ARG`，相依描述先 `COPY` 以利 layer 快取）；(3) 最後完整執行 `/jsc-doc:funcs` 處理流程（function 文件、`Dockerfile` 等指令檔逐行註解、重建 README）。當使用者說整理／重構 Dockerfile、把 Dockerfile 排成參數處理→安裝→複製→執行→縮小→入口六步、優化映像檔分層／多階段建置、縮小 image，或提到 image 時觸發。不適用於：Gitea／GitHub action 容器化（用 action-docker）、composite action（用 action-composite）、或專案內沒有也不需要 Dockerfile 的情況。
|
||||||
argument-hint: "[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路徑>] [--yes]"
|
argument-hint: "[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路徑>] [--yes]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-image — Dockerfile 六步流程整理＋文件化
|
# image — Dockerfile 六步流程整理＋文件化
|
||||||
|
|
||||||
三階段 skill：先做**前置設定與偵測**（找出專案根目錄、定位目標 `Dockerfile`、判斷語言／生態與既有建置方式），再把 `Dockerfile` **重整為固定六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口，並以多階段建置縮小最終映像），最後**完整執行 `/jsc:doc-funcs` 處理流程**替整個專案補文件並重建 README。
|
三階段 skill：先做**前置設定與偵測**（找出專案根目錄、定位目標 `Dockerfile`、判斷語言／生態與既有建置方式），再把 `Dockerfile` **重整為固定六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口，並以多階段建置縮小最終映像），最後**完整執行 `/jsc-doc:funcs` 處理流程**替整個專案補文件並重建 README。
|
||||||
|
|
||||||
| 階段 | 動作 |
|
| 階段 | 動作 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| A. 前置設定與偵測 | 決定專案根目錄 → 定位目標 `Dockerfile`（找不到則詢問，不臆造）→ 讀現有指令、判斷語言／生態、既有 base image 與建置流程 |
|
| A. 前置設定與偵測 | 決定專案根目錄 → 定位目標 `Dockerfile`（找不到則詢問，不臆造）→ 讀現有指令、判斷語言／生態、既有 base image 與建置流程 |
|
||||||
| B. 整理 Dockerfile 為六步流程 | 在**保留建置行為**前提下，把指令重整／歸位為六步：參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口；多階段建置縮小映像；行為不等價處標「需人工確認」並先確認 |
|
| B. 整理 Dockerfile 為六步流程 | 在**保留建置行為**前提下，把指令重整／歸位為六步：參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口；多階段建置縮小映像；行為不等價處標「需人工確認」並先確認 |
|
||||||
| C. 串接 doc-funcs | 對整個專案完整執行 `/jsc:doc-funcs` 流程（function 文件、`Dockerfile` 等指令檔逐行註解、重建 README） |
|
| C. 串接 funcs | 對整個專案完整執行 `/jsc-doc:funcs` 流程（function 文件、`Dockerfile` 等指令檔逐行註解、重建 README） |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -20,17 +20,17 @@ argument-hint: "[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路
|
|||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、不擴及無關檔案。
|
||||||
- `/jsc:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）。
|
- `/jsc-generic:spec-git-safety`：不破壞既有工作（絕不 `reset --hard`／`clean`）。
|
||||||
- `/jsc:spec-dockerfile`：Dockerfile 六步流程、多階段建置、對外契約不動、自我檢查。
|
- `/jsc-generic:spec-dockerfile`：Dockerfile 六步流程、多階段建置、對外契約不動、自我檢查。
|
||||||
- `/jsc:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc:doc-funcs` 的標準流程。
|
- `/jsc-generic:spec-doc-funcs-handoff`：最終階段完整執行 `/jsc-doc:funcs` 的標準流程。
|
||||||
|
|
||||||
本 skill 特有補充：
|
本 skill 特有補充：
|
||||||
|
|
||||||
- **一定會中斷詢問的點**：階段 B「重整無法可靠保證建置行為等價」時（破壞性，須先確認），以及階段 C 由 `/jsc:doc-funcs` 自身的「如何實作」詢問。
|
- **一定會中斷詢問的點**：階段 B「重整無法可靠保證建置行為等價」時（破壞性，須先確認），以及階段 C 由 `/jsc-doc:funcs` 自身的「如何實作」詢問。
|
||||||
- **保留建置行為**：重整只「重新組織與分層」既有指令，不得擅自改變最終映像的內容、檔案落點、相依版本、暴露的 port、`ENV`、`ENTRYPOINT`／`CMD` 對外契約或建置副作用；多階段建置縮小映像時，runtime 階段必須帶齊執行所需的所有產物，不得遺漏導致容器無法啟動。
|
- **保留建置行為**：重整只「重新組織與分層」既有指令，不得擅自改變最終映像的內容、檔案落點、相依版本、暴露的 port、`ENV`、`ENTRYPOINT`／`CMD` 對外契約或建置副作用；多階段建置縮小映像時，runtime 階段必須帶齊執行所需的所有產物，不得遺漏導致容器無法啟動。
|
||||||
- **本 skill 只動**：階段 A／B 只動目標 `Dockerfile`（及與其直接相關、為保留行為而必須同步的 `.dockerignore`）；其餘檔案僅在階段 C 由 doc-funcs 流程依其規範處理。
|
- **本 skill 只動**：階段 A／B 只動目標 `Dockerfile`（及與其直接相關、為保留行為而必須同步的 `.dockerignore`）；其餘檔案僅在階段 C 由 funcs 流程依其規範處理。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -40,7 +40,7 @@ argument-hint: "[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路
|
|||||||
|
|
||||||
- `--project-dir <專案根目錄>`：專案根目錄。**省略時預設目前工作目錄**。
|
- `--project-dir <專案根目錄>`：專案根目錄。**省略時預設目前工作目錄**。
|
||||||
- `--dockerfile <Dockerfile 路徑>`：指定要整理的 `Dockerfile`（相對專案根目錄）。省略時依 A2 自動定位；找到多個時詢問。
|
- `--dockerfile <Dockerfile 路徑>`：指定要整理的 `Dockerfile`（相對專案根目錄）。省略時依 A2 自動定位；找到多個時詢問。
|
||||||
- `--yes`：盡量不中斷。即使帶此參數，「重整無法保證建置行為等價」與 doc-funcs 的「如何實作」仍會詢問。
|
- `--yes`：盡量不中斷。即使帶此參數，「重整無法保證建置行為等價」與 funcs 的「如何實作」仍會詢問。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -57,18 +57,18 @@ argument-hint: "[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路
|
|||||||
- 省略 → 於專案根目錄與常見位置尋找 `Dockerfile`（含 `Dockerfile.*`、`*/Dockerfile`，排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴）。
|
- 省略 → 於專案根目錄與常見位置尋找 `Dockerfile`（含 `Dockerfile.*`、`*/Dockerfile`，排除 `node_modules`／`.git`／`.docs`／`bin`／`obj`／第三方依賴）。
|
||||||
- 恰好一個 → 直接採用。
|
- 恰好一個 → 直接採用。
|
||||||
- 多個 → 以 `AskUserQuestion` 列出讓使用者選擇要整理哪一個（或逐一整理）。
|
- 多個 → 以 `AskUserQuestion` 列出讓使用者選擇要整理哪一個（或逐一整理）。
|
||||||
- **找不到** → 回報「專案內找不到 `Dockerfile`」並詢問正確路徑；**不臆造** Dockerfile、不在沒有 Dockerfile 的專案上憑空生成（本 skill 的職責是「整理既有 Dockerfile」，產生全新 action 容器請改用 `/jsc:code-action-docker`）。
|
- **找不到** → 回報「專案內找不到 `Dockerfile`」並詢問正確路徑；**不臆造** Dockerfile、不在沒有 Dockerfile 的專案上憑空生成（本 skill 的職責是「整理既有 Dockerfile」，產生全新 action 容器請改用 `/jsc-code:action-docker`）。
|
||||||
|
|
||||||
### A3. 讀現有指令並判斷語言／生態與既有建置流程
|
### A3. 讀現有指令並判斷語言／生態與既有建置流程
|
||||||
|
|
||||||
讀取目標 `Dockerfile` 全文，盤點並記錄（作為階段 B 重整與 C doc-funcs 的依據）：
|
讀取目標 `Dockerfile` 全文，盤點並記錄（作為階段 B 重整與 C funcs 的依據）：
|
||||||
|
|
||||||
- **base image 與階段**：所有 `FROM`（含多階段 `AS <name>`）、目前是單階段或多階段。
|
- **base image 與階段**：所有 `FROM`（含多階段 `AS <name>`）、目前是單階段或多階段。
|
||||||
- **可調參數**：既有 `ARG`／`ENV`（版本、路徑、build flag 等）。
|
- **可調參數**：既有 `ARG`／`ENV`（版本、路徑、build flag 等）。
|
||||||
- **安裝步驟**：OS 套件（`apt`／`apk`／`yum` 等）、語言相依（`npm ci`／`pip install`／`go mod download`／`dotnet restore`／`mvn`／`gradle` 等）、相依描述檔（`package*.json`／`requirements.txt`／`go.mod`／`*.csproj`／`pom.xml` 等）。
|
- **安裝步驟**：OS 套件（`apt`／`apk`／`yum` 等）、語言相依（`npm ci`／`pip install`／`go mod download`／`dotnet restore`／`mvn`／`gradle` 等）、相依描述檔（`package*.json`／`requirements.txt`／`go.mod`／`*.csproj`／`pom.xml` 等）。
|
||||||
- **複製與建置**：`COPY`／`ADD` 來源與落點、`RUN` 建置／編譯／transpile（`npm run build`／`go build`／`dotnet publish`／`mvn package` 等）、`WORKDIR`、`USER`、檔案權限（`chmod`）。
|
- **複製與建置**：`COPY`／`ADD` 來源與落點、`RUN` 建置／編譯／transpile（`npm run build`／`go build`／`dotnet publish`／`mvn package` 等）、`WORKDIR`、`USER`、檔案權限（`chmod`）。
|
||||||
- **執行設定**：`EXPOSE`、`ENV`、`VOLUME`、`HEALTHCHECK`、`ENTRYPOINT`／`CMD`（這些是對外契約，重整時不得改變語意）。
|
- **執行設定**：`EXPOSE`、`ENV`、`VOLUME`、`HEALTHCHECK`、`ENTRYPOINT`／`CMD`（這些是對外契約，重整時不得改變語意）。
|
||||||
- **語言／生態**：依 base image 與安裝指令、專案檔分布推斷主要語言（供階段 C doc-funcs 第 0 步沿用，也決定縮小映像時的 runtime 基底選擇）。
|
- **語言／生態**：依 base image 與安裝指令、專案檔分布推斷主要語言（供階段 C funcs 第 0 步沿用，也決定縮小映像時的 runtime 基底選擇）。
|
||||||
|
|
||||||
輸出偵測結果（目標 Dockerfile 路徑、單／多階段、base image、推斷語言、既有 `ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV`），再進入階段 B。
|
輸出偵測結果（目標 Dockerfile 路徑、單／多階段、base image、推斷語言、既有 `ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV`），再進入階段 B。
|
||||||
|
|
||||||
@@ -76,7 +76,7 @@ argument-hint: "[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路
|
|||||||
|
|
||||||
## 階段 B：整理 Dockerfile 為六步流程
|
## 階段 B：整理 Dockerfile 為六步流程
|
||||||
|
|
||||||
在**保留建置行為**的前提下，把目標 `Dockerfile` 的指令重整／歸位為 `/jsc:spec-dockerfile` 定義的**固定六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口），並採**多階段建置**縮小最終映像；各步要點（ARG 集中檔首、相依描述先 `COPY`、同層清理快取、`COPY --from` 逐項明列、搬移 runtime 需要的 `ENV`／`WORKDIR`／`EXPOSE`／`USER`）依該 spec。
|
在**保留建置行為**的前提下，把目標 `Dockerfile` 的指令重整／歸位為 `/jsc-generic:spec-dockerfile` 定義的**固定六步流程**（參數處理 → 安裝套件 → 複製檔案 → 執行程序 → 縮小映像檔 → 設定入口），並採**多階段建置**縮小最終映像；各步要點（ARG 集中檔首、相依描述先 `COPY`、同層清理快取、`COPY --from` 逐項明列、搬移 runtime 需要的 `ENV`／`WORKDIR`／`EXPOSE`／`USER`）依該 spec。
|
||||||
|
|
||||||
**重整原則（關鍵）**
|
**重整原則（關鍵）**
|
||||||
|
|
||||||
@@ -84,7 +84,7 @@ argument-hint: "[--project-dir <專案根目錄>] [--dockerfile <Dockerfile 路
|
|||||||
- **已是多階段** → 將既有各階段對應到六步（build 階段涵蓋 1–4、runtime 階段涵蓋 5–6），補齊缺漏的快取最佳化與清理，不破壞既有 `--from` 依賴。
|
- **已是多階段** → 將既有各階段對應到六步（build 階段涵蓋 1–4、runtime 階段涵蓋 5–6），補齊缺漏的快取最佳化與清理，不破壞既有 `--from` 依賴。
|
||||||
- **單階段改多階段** → 僅在能可靠判斷 runtime 真正需要哪些產物時才做；無法可靠判斷時，**不臆測**，標 `# 需人工確認：runtime 需要的產物清單` 並回報，退回「最小重排＋補註解」。
|
- **單階段改多階段** → 僅在能可靠判斷 runtime 真正需要哪些產物時才做；無法可靠判斷時，**不臆測**，標 `# 需人工確認：runtime 需要的產物清單` 並回報，退回「最小重排＋補註解」。
|
||||||
- **多階段不適用** → 若該映像本質上無法受益於多階段（例如純資料映像、最終就是要完整建置環境），保留單階段，於步驟 5 以註解說明「此映像不適用多階段縮小」，其餘步驟仍依序歸位。
|
- **多階段不適用** → 若該映像本質上無法受益於多階段（例如純資料映像、最終就是要完整建置環境），保留單階段，於步驟 5 以註解說明「此映像不適用多階段縮小」，其餘步驟仍依序歸位。
|
||||||
- **對外契約不動**：依 `/jsc:spec-dockerfile`（`ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV`／`VOLUME`／`HEALTHCHECK`／`USER` 語意與原檔一致，只可調整位置與分層）。
|
- **對外契約不動**：依 `/jsc-generic:spec-dockerfile`（`ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV`／`VOLUME`／`HEALTHCHECK`／`USER` 語意與原檔一致，只可調整位置與分層）。
|
||||||
- **`.dockerignore`**：若為了「複製檔案」步驟的正確性需要排除建置產物／`node_modules`／`.git`，可建立或補強 `.dockerignore`（僅新增排除項，不刪既有），並回報。
|
- **`.dockerignore`**：若為了「複製檔案」步驟的正確性需要排除建置產物／`node_modules`／`.git`，可建立或補強 `.dockerignore`（僅新增排除項，不刪既有），並回報。
|
||||||
|
|
||||||
重整骨架（實際指令、base image、語言依階段 A 偵測結果填入；非 Node 專案請換成對應語言的安裝／建置指令與 runtime 基底）：
|
重整骨架（實際指令、base image、語言依階段 A 偵測結果填入；非 Node 專案請換成對應語言的安裝／建置指令與 runtime 基底）：
|
||||||
@@ -120,15 +120,15 @@ COPY --from=build /app/<artifacts> ./<artifacts>
|
|||||||
ENTRYPOINT [<entrypoint>]
|
ENTRYPOINT [<entrypoint>]
|
||||||
```
|
```
|
||||||
|
|
||||||
- **自我檢查**：依 `/jsc:spec-dockerfile` 的自我檢查清單（跨階段 `ARG` 重新宣告、runtime 帶齊產物、對外契約一致、路徑一致）。
|
- **自我檢查**：依 `/jsc-generic:spec-dockerfile` 的自我檢查清單（跨階段 `ARG` 重新宣告、runtime 帶齊產物、對外契約一致、路徑一致）。
|
||||||
- 此檔的「用途／更新日期」開頭註解區塊與逐行註解，於階段 C 由 `/jsc:doc-funcs` 的指令檔流程統一補齊／覆寫為標準格式；本階段先確保**建置行為**正確、六步結構清楚即可。
|
- 此檔的「用途／更新日期」開頭註解區塊與逐行註解，於階段 C 由 `/jsc-doc:funcs` 的指令檔流程統一補齊／覆寫為標準格式；本階段先確保**建置行為**正確、六步結構清楚即可。
|
||||||
- **建置驗證**：若環境可執行 `docker build`，重整後做一次建置驗證（或至少 `docker build --check`／語法檢查）確認可建置；無法執行時明確說明原因並標註風險（階段 C doc-funcs 第 11 步亦會做語法驗證）。
|
- **建置驗證**：若環境可執行 `docker build`，重整後做一次建置驗證（或至少 `docker build --check`／語法檢查）確認可建置；無法執行時明確說明原因並標註風險（階段 C funcs 第 11 步亦會做語法驗證）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 階段 C：完整執行 /jsc:doc-funcs 處理流程
|
## 階段 C：完整執行 /jsc-doc:funcs 處理流程
|
||||||
|
|
||||||
Dockerfile 六步整理完成後，以階段 A1 的專案根目錄為目標，依 `/jsc:spec-doc-funcs-handoff` 對**整個專案**完整執行 `/jsc:doc-funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次整理的 `Dockerfile` 會被視為部署設定檔補齊標頭與逐行註解）。
|
Dockerfile 六步整理完成後，以階段 A1 的專案根目錄為目標，依 `/jsc-generic:spec-doc-funcs-handoff` 對**整個專案**完整執行 `/jsc-doc:funcs` 流程（前置可用性檢查、完整流程、由使用者裁示實作方式、重建 README；本次整理的 `Dockerfile` 會被視為部署設定檔補齊標頭與逐行註解）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -138,7 +138,7 @@ Dockerfile 六步整理完成後，以階段 A1 的專案根目錄為目標，
|
|||||||
|
|
||||||
- **階段 A**：專案根目錄、目標 `Dockerfile` 路徑、單／多階段、base image、推斷語言、既有 `ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV`。
|
- **階段 A**：專案根目錄、目標 `Dockerfile` 路徑、單／多階段、base image、推斷語言、既有 `ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV`。
|
||||||
- **階段 B**：重整摘要（六步歸位結果、是否改為多階段、縮小映像採用的 runtime 基底）、「需人工確認」清單、是否做過建置／語法驗證；並確認對外契約（`ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV` 等）未被破壞。
|
- **階段 B**：重整摘要（六步歸位結果、是否改為多階段、縮小映像採用的 runtime 基底）、「需人工確認」清單、是否做過建置／語法驗證；並確認對外契約（`ENTRYPOINT`／`CMD`／`EXPOSE`／`ENV` 等）未被破壞。
|
||||||
- **階段 C**：doc-funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
- **階段 C**：funcs 流程的處理結果（文件化的 function 與指令檔、重建的 README）。
|
||||||
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `Dockerfile` 可正確建置、容器能正常啟動。
|
- 列出本次新增／變更的檔案與其相對路徑，並提醒使用者於提交前確認 `Dockerfile` 可正確建置、容器能正常啟動。
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -149,6 +149,6 @@ Dockerfile 六步整理完成後，以階段 A1 的專案根目錄為目標，
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-image`，或 `/jsc:code-image --project-dir ~/work/my-app --dockerfile build/Dockerfile` |
|
| Claude Code / Antigravity | `/jsc-code:image`，或 `/jsc-code:image --project-dir ~/work/my-app --dockerfile build/Dockerfile` |
|
||||||
| Codex | `$code-image`，或 `$code-image --dockerfile docker/Dockerfile`，或用 `/skills` 選單 |
|
| Codex | `$image`，或 `$image --dockerfile docker/Dockerfile`，或用 `/skills` 選單 |
|
||||||
| OpenCode | 描述需求（如「把這個專案的 Dockerfile 整理成參數處理→安裝套件→複製檔案→執行程序→縮小映像檔→設定入口六步、用多階段建置縮小映像，最後跑 doc-funcs 補文件並重建 README」）自動觸發 |
|
| OpenCode | 描述需求（如「把這個專案的 Dockerfile 整理成參數處理→安裝套件→複製檔案→執行程序→縮小映像檔→設定入口六步、用多階段建置縮小映像，最後跑 funcs 補文件並重建 README」）自動觸發 |
|
||||||
@@ -1,10 +1,10 @@
|
|||||||
---
|
---
|
||||||
name: code-issues
|
name: issues
|
||||||
description: 處理一或多個 Gitea 議題的實作流程：先選擇使用 `tea` 或 Gitea REST API + `GITEA_TOKEN`（已選定則跳過），再確認議題所在專案（已知則跳過）與要處理的議題編號（一或多個）；接著讀取議題描述與留言、彙整需求，整理 TODO 列表並依影響範圍由小到大排序，既有 TODO 不足以達成議題需求時補上新 TODO 並附加到議題描述；最後逐項實作 TODO，每完成一項就把進度留言到議題。全程不建立任何草稿檔，中間成果一律用議題描述或留言保存，並盡量以表格與 Mermaid 圖呈現。當使用者說處理議題、實作議題、依議題 TODO 開工、把議題需求整理成 TODO 並逐項完成、議題進度留言，或提到 code-issues、issue 實作、Gitea 議題處理時觸發。不適用於：把需求拆分成多個新議題（用 doc-issues-analyze）、只同步議題狀態不實作（用 doc-issues-sync）、或與 Gitea 無關的本機 TODO 管理。
|
description: 處理一或多個 Gitea 議題的實作流程：先選擇使用 `tea` 或 Gitea REST API + `GITEA_TOKEN`（已選定則跳過），再確認議題所在專案（已知則跳過）與要處理的議題編號（一或多個）；接著讀取議題描述與留言、彙整需求，整理 TODO 列表並依影響範圍由小到大排序，既有 TODO 不足以達成議題需求時補上新 TODO 並附加到議題描述；最後逐項實作 TODO，每完成一項就把進度留言到議題。全程不建立任何草稿檔，中間成果一律用議題描述或留言保存，並盡量以表格與 Mermaid 圖呈現。當使用者說處理議題、實作議題、依議題 TODO 開工、把議題需求整理成 TODO 並逐項完成、議題進度留言，或提到 issues、issue 實作、Gitea 議題處理時觸發。不適用於：把需求拆分成多個新議題（用 issues-analyze）、只同步議題狀態不實作（用 issues-sync）、或與 Gitea 無關的本機 TODO 管理。
|
||||||
argument-hint: "[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以逗號分隔>] [--host <gitea 主機>] [--yes]"
|
argument-hint: "[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以逗號分隔>] [--host <gitea 主機>] [--yes]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-issues — 彙整議題 TODO 並逐項實作、留言進度
|
# issues — 彙整議題 TODO 並逐項實作、留言進度
|
||||||
|
|
||||||
五階段 skill：先做**工具選擇**（`tea` 或 Gitea REST API + `GITEA_TOKEN`），再**確認議題所在專案**與**要處理的議題編號**，接著**讀取議題並彙整 TODO 列表**（依影響範圍小→大排序，缺漏的 TODO 附加到議題描述），最後**逐項實作 TODO**，每完成一項就把進度**留言到議題**。
|
五階段 skill：先做**工具選擇**（`tea` 或 Gitea REST API + `GITEA_TOKEN`），再**確認議題所在專案**與**要處理的議題編號**，接著**讀取議題並彙整 TODO 列表**（依影響範圍小→大排序，缺漏的 TODO 附加到議題描述），最後**逐項實作 TODO**，每完成一項就把進度**留言到議題**。
|
||||||
|
|
||||||
@@ -21,15 +21,15 @@ argument-hint: "[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以
|
|||||||
## 絕對準則（不可違反）
|
## 絕對準則（不可違反）
|
||||||
|
|
||||||
- **不建立任何草稿檔**：不寫 `.docs/`、不寫暫存檔、不用本機檔案傳遞中間結果。需求彙整、TODO 排序、實作進度、驗證結果等所有中間成果，一律留在**對話內容**，並透過 `tea` 或 Gitea API **保存到議題描述或議題留言**。唯一例外是階段 E 在議題範圍內對**目標 repo 原始碼**的正常程式修改。
|
- **不建立任何草稿檔**：不寫 `.docs/`、不寫暫存檔、不用本機檔案傳遞中間結果。需求彙整、TODO 排序、實作進度、驗證結果等所有中間成果，一律留在**對話內容**，並透過 `tea` 或 Gitea API **保存到議題描述或議題留言**。唯一例外是階段 E 在議題範圍內對**目標 repo 原始碼**的正常程式修改。
|
||||||
- **盡量使用表格或圖形**：依 `/jsc:spec-output` — 面向使用者的輸出與寫入議題的內容（需求彙整、TODO 列表、進度回報），優先以 Markdown 表格與 Mermaid 圖呈現，忠實反映議題內容、不得杜撰。
|
- **盡量使用表格或圖形**：依 `/jsc-generic:spec-output` — 面向使用者的輸出與寫入議題的內容（需求彙整、TODO 列表、進度回報），優先以 Markdown 表格與 Mermaid 圖呈現，忠實反映議題內容、不得杜撰。
|
||||||
|
|
||||||
## 共用規範（generic plugin，必要前置）
|
## 共用規範（generic plugin，必要前置）
|
||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼、API body 以 UTF-8 JSON 檔帶入且換行為實際換行。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼、API body 以 UTF-8 JSON 檔帶入且換行為實際換行。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、已知資訊跳過詢問。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認、已知資訊跳過詢問。
|
||||||
- `/jsc:spec-gitea`：tea／API 工具選擇與檢查、`GITEA_TOKEN` 機密保護（不 echo、遮蔽）、不依賴 `jq`、API 分頁完整讀取。
|
- `/jsc-generic:spec-gitea`：tea／API 工具選擇與檢查、`GITEA_TOKEN` 機密保護（不 echo、遮蔽）、不依賴 `jq`、API 分頁完整讀取。
|
||||||
|
|
||||||
本 skill 特有補充：
|
本 skill 特有補充：
|
||||||
|
|
||||||
@@ -54,7 +54,7 @@ argument-hint: "[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以
|
|||||||
|
|
||||||
**若使用者已透過 `--tool` 或對話明確選定工具，跳過詢問**，只做該工具的可用性驗證。
|
**若使用者已透過 `--tool` 或對話明確選定工具，跳過詢問**，只做該工具的可用性驗證。
|
||||||
|
|
||||||
依 `/jsc:spec-gitea` 的工具選擇流程執行：檢查 `tea`（`command -v tea`、`tea login list`）與 `GITEA_TOKEN`（只輸出「已設定／未設定」）→ 以表格呈現檢查結果後詢問使用者要用 `tea` 或 `api` → 兩種方式都不可用則回報並停止（不要請使用者把 token 貼進對話）。
|
依 `/jsc-generic:spec-gitea` 的工具選擇流程執行：檢查 `tea`（`command -v tea`、`tea login list`）與 `GITEA_TOKEN`（只輸出「已設定／未設定」）→ 以表格呈現檢查結果後詢問使用者要用 `tea` 或 `api` → 兩種方式都不可用則回報並停止（不要請使用者把 token 貼進對話）。
|
||||||
|
|
||||||
## 階段 B：確認議題所在專案（已知則跳過）
|
## 階段 B：確認議題所在專案（已知則跳過）
|
||||||
|
|
||||||
@@ -130,7 +130,7 @@ argument-hint: "[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以
|
|||||||
- 留言內容以表格呈現：本項 TODO、影響範圍、主要變更（檔案／模組）、驗證方式與結果、整體進度（`已完成 n/總數 m`）；有助理解時附 Mermaid 圖。
|
- 留言內容以表格呈現：本項 TODO、影響範圍、主要變更（檔案／模組）、驗證方式與結果、整體進度（`已完成 n/總數 m`）；有助理解時附 Mermaid 圖。
|
||||||
5. 全部 TODO 完成後，對每個議題留下**總結留言**：TODO 完成統計表、變更檔案清單、驗證總結、待人工處理項目（若有）。
|
5. 全部 TODO 完成後，對每個議題留下**總結留言**：TODO 完成統計表、變更檔案清單、驗證總結、待人工處理項目（若有）。
|
||||||
|
|
||||||
> 本 skill 範圍到「實作＋留言」為止；是否 commit、push、開 PR 或關閉議題**不在本 skill 自動範圍**，由使用者另行指示（可搭配 `code-review-resolve` 的分類提交與 PR 流程）。
|
> 本 skill 範圍到「實作＋留言」為止；是否 commit、push、開 PR 或關閉議題**不在本 skill 自動範圍**，由使用者另行指示（可搭配 `review-resolve` 的分類提交與 PR 流程）。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -152,6 +152,6 @@ argument-hint: "[--tool <tea|api>] [--repo <owner/repo>] [--issues <編號,以
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-issues`，或 `/jsc:code-issues --tool api --repo plugins/code --issues 12,15 --yes` |
|
| Claude Code / Antigravity | `/jsc-code:issues`，或 `/jsc-code:issues --tool api --repo plugins/code --issues 12,15 --yes` |
|
||||||
| Codex | `$code-issues`，或 `$code-issues --tool tea --repo plugins/code --issues 12`，或用 `/skills` 選單 |
|
| Codex | `$issues`，或 `$issues --tool tea --repo plugins/code --issues 12`，或用 `/skills` 選單 |
|
||||||
| OpenCode | 描述需求（如「用 GITEA_TOKEN 讀 plugins/code 的 12、15 號議題，整理需求成 TODO 依影響範圍小到大排序、缺的補進議題描述，然後逐項實作、每完成一項留言進度」）自動觸發 |
|
| OpenCode | 描述需求（如「用 GITEA_TOKEN 讀 plugins/code 的 12、15 號議題，整理需求成 TODO 依影響範圍小到大排序、缺的補進議題描述，然後逐項實作、每完成一項留言進度」）自動觸發 |
|
||||||
@@ -1,10 +1,10 @@
|
|||||||
---
|
---
|
||||||
name: code-nuget
|
name: nuget
|
||||||
description: 將 C# / .NET 專案的 NuGet 套件更新到最新可用版本。當使用者要求更新 NuGet、升級 PackageReference、清理重複套件參考、檢查專案參考中的重複 NuGet、或逐包更新並確認 build 時觸發。流程會依專案分組列出套件，檢查 ProjectReference 上層專案是否已引用相同套件並移除可安全移除的重複參考，接著逐一更新套件版本；每更新或移除一個套件都必須 restore/build 驗證。若更新到最新版本後編譯失敗，改由目前版本之後的最小可用版本逐版升級，直到遇到第一個編譯失敗版本，保留最後一個可編譯版本。不適用於：非 .NET 專案、只想查詢套件清單不更新、或只要人工建議不修改檔案。
|
description: 將 C# / .NET 專案的 NuGet 套件更新到最新可用版本。當使用者要求更新 NuGet、升級 PackageReference、清理重複套件參考、檢查專案參考中的重複 NuGet、或逐包更新並確認 build 時觸發。流程會依專案分組列出套件，檢查 ProjectReference 上層專案是否已引用相同套件並移除可安全移除的重複參考，接著逐一更新套件版本；每更新或移除一個套件都必須 restore/build 驗證。若更新到最新版本後編譯失敗，改由目前版本之後的最小可用版本逐版升級，直到遇到第一個編譯失敗版本，保留最後一個可編譯版本。不適用於：非 .NET 專案、只想查詢套件清單不更新、或只要人工建議不修改檔案。
|
||||||
argument-hint: "[<solution-or-project>] [--include-prerelease] [--no-dedupe] [--build <command>] [--yes]"
|
argument-hint: "[<solution-or-project>] [--include-prerelease] [--no-dedupe] [--build <command>] [--yes]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-nuget — 更新 C# 專案 NuGet 套件
|
# nuget — 更新 C# 專案 NuGet 套件
|
||||||
|
|
||||||
把 C# / .NET repo 內的 NuGet 套件依專案盤點、清理可安全移除的重複參考，然後逐一更新到最新可用版本。每個套件異動後都要驗證專案可以正常編譯；若最新版本失敗，改從目前版本之後的最小可用版本逐版升級，直到第一個編譯失敗版本為止，保留最後一個可編譯版本並記錄失敗點。
|
把 C# / .NET repo 內的 NuGet 套件依專案盤點、清理可安全移除的重複參考，然後逐一更新到最新可用版本。每個套件異動後都要驗證專案可以正常編譯；若最新版本失敗，改從目前版本之後的最小可用版本逐版升級，直到第一個編譯失敗版本為止，保留最後一個可編譯版本並記錄失敗點。
|
||||||
|
|
||||||
@@ -12,8 +12,8 @@ argument-hint: "[<solution-or-project>] [--include-prerelease] [--no-dedupe] [--
|
|||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼（套件 id、檔名、指令、版本號保留原文）。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼（套件 id、檔名、指令、版本號保留原文）。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
||||||
|
|
||||||
## 輸出規範（本 skill 特有）
|
## 輸出規範（本 skill 特有）
|
||||||
|
|
||||||
@@ -157,6 +157,6 @@ argument-hint: "[<solution-or-project>] [--include-prerelease] [--no-dedupe] [--
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-nuget`，或 `/jsc:code-nuget MySolution.sln --include-prerelease` |
|
| Claude Code / Antigravity | `/jsc-code:nuget`，或 `/jsc-code:nuget MySolution.sln --include-prerelease` |
|
||||||
| Codex | `$code-nuget`，或 `$code-nuget src/App/App.csproj --build "dotnet build App.sln -c Release"` |
|
| Codex | `$nuget`，或 `$nuget src/App/App.csproj --build "dotnet build App.sln -c Release"` |
|
||||||
| OpenCode | 描述需求（如「把這個 .NET solution 的 NuGet 都更新到最新，先清掉 ProjectReference 已提供的重複套件，每更新一包就 build」）自動觸發 |
|
| OpenCode | 描述需求（如「把這個 .NET solution 的 NuGet 都更新到最新，先清掉 ProjectReference 已提供的重複套件，每更新一包就 build」）自動觸發 |
|
||||||
@@ -1,10 +1,10 @@
|
|||||||
---
|
---
|
||||||
name: code-review-resolve
|
name: review-resolve
|
||||||
description: 解決新版 AI Code Review 的 findings——一律讀取專案內 `.gitea/ai-review/findings/` 目錄下的 wrapper 物件 JSON（含 `findings`/`excluded` 陣列、中文 severity）與 `findings.json`，並可額外用 `--issue`（無/單選/多選/全部）從 Gitea 議題（建問題模式）解析嚴重問題留言為 findings，兩來源合併去重後逐條解決；先同步 git（fetch → 檢查目前分支的遠端分支是否存在；存在則留在目前分支 pull 更新，不存在則切換到 develop／master 後 pull 更新；只有來源分支與 PR 目標分支相同時才建立新的工作分支；必要時嘗試解衝突），再依嚴重度（嚴重/警告/建議）逐條修復；可判斷為誤報者寫入 `.gitea/ai-review/exclusions.json`，已解決或已登記為誤報的 finding 逐檔就地自來源 wrapper 移除；處理過的議題於留言進度、把只來自議題的待人工處理問題寫回 findings 目錄後關閉；接著可將工作區變更依 conventional commit 類型分類提交、push 當前分支，並透過 Gitea API 對指定目標分支開 PR。當使用者說解決 findings、處理 AI review 問題、依議題編號修 code review 問題、修掉 `.gitea/ai-review` 問題、依嚴重度修復後分類提交，或要分類 commit 並 push/開 PR 時觸發。不適用於：產生 findings、單純 code review 不修改、只保存裁決紀錄，或只要不分類的單一 commit。
|
description: 解決新版 AI Code Review 的 findings——一律讀取專案內 `.gitea/ai-review/findings/` 目錄下的 wrapper 物件 JSON（含 `findings`/`excluded` 陣列、中文 severity）與 `findings.json`，並可額外用 `--issue`（無/單選/多選/全部）從 Gitea 議題（建問題模式）解析嚴重問題留言為 findings，兩來源合併去重後逐條解決；先同步 git（fetch → 檢查目前分支的遠端分支是否存在；存在則留在目前分支 pull 更新，不存在則切換到 develop／master 後 pull 更新；只有來源分支與 PR 目標分支相同時才建立新的工作分支；必要時嘗試解衝突），再依嚴重度（嚴重/警告/建議）逐條修復；可判斷為誤報者寫入 `.gitea/ai-review/exclusions.json`，已解決或已登記為誤報的 finding 逐檔就地自來源 wrapper 移除；處理過的議題於留言進度、把只來自議題的待人工處理問題寫回 findings 目錄後關閉；接著可將工作區變更依 conventional commit 類型分類提交、push 當前分支，並透過 Gitea API 對指定目標分支開 PR。當使用者說解決 findings、處理 AI review 問題、依議題編號修 code review 問題、修掉 `.gitea/ai-review` 問題、依嚴重度修復後分類提交，或要分類 commit 並 push/開 PR 時觸發。不適用於：產生 findings、單純 code review 不修改、只保存裁決紀錄，或只要不分類的單一 commit。
|
||||||
argument-hint: "[--issue <編號|編號清單|all>] [--findings <findings 檔或目錄路徑>] [--target <目標分支>] [--pr-desc <full|simple|自訂文字>] [--no-commit] [--no-pr] [--yes]"
|
argument-hint: "[--issue <編號|編號清單|all>] [--findings <findings 檔或目錄路徑>] [--target <目標分支>] [--pr-desc <full|simple|自訂文字>] [--no-commit] [--no-pr] [--yes]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-review-resolve — 解決 AI review findings、分類提交、push 並開 PR
|
# review-resolve — 解決 AI review findings、分類提交、push 並開 PR
|
||||||
|
|
||||||
五階段 skill：先執行 **git 同步**（`git fetch` → 確認目前分支的遠端分支是否存在；存在則留在目前分支 `git pull` 更新，不存在則切換到 `develop`，再退而 `master` 後 `git pull` 更新；只有來源分支與 PR 目標分支相同時才建立新的工作分支；必要時告知並嘗試解衝突），再**蒐集問題來源**——**一律讀** `.gitea/ai-review/findings/` 目錄下的 wrapper 物件 JSON（取其 `findings` 陣列）與 `findings.json`，並依 `--issue`（無／單選／多選／全部）**額外**從 Gitea 議題留言解析嚴重問題，兩來源**合併去重**後逐條處理；成立問題修復後自來源 wrapper 逐檔就地移除，可判斷為誤報者寫入 `.gitea/ai-review/exclusions.json` 後也可移除（處理過的議題於留言進度、把只來自議題的待人工處理問題寫回 findings 目錄後關閉），接著**必須盤點並處理工作區的所有變更**，再依 conventional commit 類型分門別類 commit，然後 **push 當前分支**，最後**透過 Gitea API 發 PR**。
|
五階段 skill：先執行 **git 同步**（`git fetch` → 確認目前分支的遠端分支是否存在；存在則留在目前分支 `git pull` 更新，不存在則切換到 `develop`，再退而 `master` 後 `git pull` 更新；只有來源分支與 PR 目標分支相同時才建立新的工作分支；必要時告知並嘗試解衝突），再**蒐集問題來源**——**一律讀** `.gitea/ai-review/findings/` 目錄下的 wrapper 物件 JSON（取其 `findings` 陣列）與 `findings.json`，並依 `--issue`（無／單選／多選／全部）**額外**從 Gitea 議題留言解析嚴重問題，兩來源**合併去重**後逐條處理；成立問題修復後自來源 wrapper 逐檔就地移除，可判斷為誤報者寫入 `.gitea/ai-review/exclusions.json` 後也可移除（處理過的議題於留言進度、把只來自議題的待人工處理問題寫回 findings 目錄後關閉），接著**必須盤點並處理工作區的所有變更**，再依 conventional commit 類型分門別類 commit，然後 **push 當前分支**，最後**透過 Gitea API 發 PR**。
|
||||||
|
|
||||||
@@ -22,10 +22,10 @@ argument-hint: "[--issue <編號|編號清單|all>] [--findings <findings 檔或
|
|||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼（含 commit 訊息、PR 標題／描述、寫檔／API body 實作要點與送出前自我檢查）。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼（含 commit 訊息、PR 標題／描述、寫檔／API body 實作要點與送出前自我檢查）。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
||||||
- `/jsc:spec-gitea`：`GITEA_TOKEN` 機密保護（不 echo、遮蔽 `***`）、API body 以 UTF-8 JSON 檔帶入。
|
- `/jsc-generic:spec-gitea`：`GITEA_TOKEN` 機密保護（不 echo、遮蔽 `***`）、API body 以 UTF-8 JSON 檔帶入。
|
||||||
- `/jsc:spec-git-safety`：不破壞既有工作、develop → master 後備、保守解衝突、新分支不覆蓋既有分支。
|
- `/jsc-generic:spec-git-safety`：不破壞既有工作、develop → master 後備、保守解衝突、新分支不覆蓋既有分支。
|
||||||
|
|
||||||
本 skill 特有補充：
|
本 skill 特有補充：
|
||||||
|
|
||||||
@@ -136,7 +136,7 @@ source_branch="$(git rev-parse --abbrev-ref HEAD)"
|
|||||||
|
|
||||||
### A6. 必要時嘗試解衝突
|
### A6. 必要時嘗試解衝突
|
||||||
|
|
||||||
當 `git pull` 後出現衝突，依 `/jsc:spec-git-safety` 的保守解衝突流程處理（定位衝突檔 → 最小合理整合 → 可安全解決者 `git add` 標記、無法安全判斷者停止並列出決策點）；全部衝突解完後，依 git 當前狀態完成 merge / rebase 的必要步驟，確認 `git status --porcelain` 沒有未解衝突，再回到 A5 判斷是否需要建立新工作分支。
|
當 `git pull` 後出現衝突，依 `/jsc-generic:spec-git-safety` 的保守解衝突流程處理（定位衝突檔 → 最小合理整合 → 可安全解決者 `git add` 標記、無法安全判斷者停止並列出決策點）；全部衝突解完後，依 git 當前狀態完成 merge / rebase 的必要步驟，確認 `git status --porcelain` 沒有未解衝突，再回到 A5 判斷是否需要建立新工作分支。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -300,7 +300,7 @@ source_branch="$(git rev-parse --abbrev-ref HEAD)"
|
|||||||
"generatedAt": "<台北時間>",
|
"generatedAt": "<台北時間>",
|
||||||
"commitSha": "<目前 HEAD sha>",
|
"commitSha": "<目前 HEAD sha>",
|
||||||
"prNumber": null,
|
"prNumber": null,
|
||||||
"tool": { "name": "code-review-resolve", "version": "<版本或工具預設>", "model": "<模型或工具預設>" },
|
"tool": { "name": "review-resolve", "version": "<版本或工具預設>", "model": "<模型或工具預設>" },
|
||||||
"findings": [ { "id": "F001", "reviewer": "...", "severity": "嚴重|警告|建議", "file": "...", "startLine": 1, "endLine": 1, "problem": "...", "suggestion": "...", "suggestedCode": "" } ],
|
"findings": [ { "id": "F001", "reviewer": "...", "severity": "嚴重|警告|建議", "file": "...", "startLine": 1, "endLine": 1, "problem": "...", "suggestion": "...", "suggestedCode": "" } ],
|
||||||
"excluded": []
|
"excluded": []
|
||||||
}
|
}
|
||||||
@@ -367,7 +367,7 @@ git ls-files --others --exclude-standard # 未追蹤檔
|
|||||||
- `type`：上表英文類型。
|
- `type`：上表英文類型。
|
||||||
- `範圍`（括號內）：**必須是這組異動實際牽涉的功能／模組／元件名稱**，而**不是**重述 type 的類別詞。
|
- `範圍`（括號內）：**必須是這組異動實際牽涉的功能／模組／元件名稱**，而**不是**重述 type 的類別詞。
|
||||||
取名規則：優先沿用程式碼／專案中既有的識別名（檔名、模組名、skill 名、功能名，可中可英、保持與原碼一致），讓人一眼看出「改到哪個東西」。
|
取名規則：優先沿用程式碼／專案中既有的識別名（檔名、模組名、skill 名、功能名，可中可英、保持與原碼一致），讓人一眼看出「改到哪個東西」。
|
||||||
- ✅ 對：`feat(使用者登入)`、`fix(結帳流程)`、`perf(物件查詢)`、`docs(README)`、`refactor(訂單服務)`、`chore(plugin 版本)`、`feat(code-review-resolve)`。
|
- ✅ 對：`feat(使用者登入)`、`fix(結帳流程)`、`perf(物件查詢)`、`docs(README)`、`refactor(訂單服務)`、`chore(plugin 版本)`、`feat(review-resolve)`。
|
||||||
- ❌ 錯（只是重述 type，禁止）：`feat(新增功能)`、`fix(修正錯誤)`、`perf(優化效能)`、`docs(文件)`、`chore(雜項)`。
|
- ❌ 錯（只是重述 type，禁止）：`feat(新增功能)`、`fix(修正錯誤)`、`perf(優化效能)`、`docs(文件)`、`chore(雜項)`。
|
||||||
- 一組異動橫跨多個功能而無單一主體時，才退而取最貼近的上層範圍（例如多個 manifest → `plugin 設定`）。
|
- 一組異動橫跨多個功能而無單一主體時，才退而取最貼近的上層範圍（例如多個 manifest → `plugin 設定`）。
|
||||||
- `一句總結`：把這個 commit 內所有異動**總結成一句**繁體中文（簡短、聚焦做了什麼）。
|
- `一句總結`：把這個 commit 內所有異動**總結成一句**繁體中文（簡短、聚焦做了什麼）。
|
||||||
@@ -548,6 +548,6 @@ curl -sS -X POST \
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-review-resolve`，或 `/jsc:code-review-resolve --target develop --pr-desc full --yes`、`/jsc:code-review-resolve --issue 12,15 --target master`、`/jsc:code-review-resolve --issue all --target master`、`/jsc:code-review-resolve --no-pr`、`/jsc:code-review-resolve --no-commit` |
|
| Claude Code / Antigravity | `/jsc-code:review-resolve`，或 `/jsc-code:review-resolve --target develop --pr-desc full --yes`、`/jsc-code:review-resolve --issue 12,15 --target master`、`/jsc-code:review-resolve --issue all --target master`、`/jsc-code:review-resolve --no-pr`、`/jsc-code:review-resolve --no-commit` |
|
||||||
| Codex | `$code-review-resolve`，或 `$code-review-resolve --target develop --pr-desc full --yes`、`$code-review-resolve --issue all --target master`，或用 `/skills` 選單 |
|
| Codex | `$review-resolve`，或 `$review-resolve --target develop --pr-desc full --yes`、`$review-resolve --issue all --target master`，或用 `/skills` 選單 |
|
||||||
| OpenCode | 描述需求（如「讀 .gitea/ai-review/findings/ 目錄與 findings.json 的 wrapper findings，再併入議題 #12、#15 的 code review 問題去重後依嚴重度逐條處理，更新 findings/exclusions，把工作區變更依 conventional commit 分類提交，push 後對 develop 發 PR（完整版描述）」）自動觸發 |
|
| OpenCode | 描述需求（如「讀 .gitea/ai-review/findings/ 目錄與 findings.json 的 wrapper findings，再併入議題 #12、#15 的 code review 問題去重後依嚴重度逐條處理，更新 findings/exclusions，把工作區變更依 conventional commit 分類提交，push 後對 develop 發 PR（完整版描述）」）自動觸發 |
|
||||||
@@ -1,10 +1,10 @@
|
|||||||
---
|
---
|
||||||
name: code-sync
|
name: sync
|
||||||
description: 透過 `GITEA_TOKEN` 取得使用者有讀取權限的所有 Gitea 專案，依擁有者（owner）分組後列出讓使用者多選，再把選定擁有者底下有讀取權限的專案，於目標目錄（預設家目錄）依擁有者建立資料夾並逐一 clone；若專案已存在，則切換到 develop（再退而 master）並更新到最新。當使用者說同步 Gitea 專案、批次 clone、把某些擁有者的 repo 全抓下來、依擁有者分類 clone、批次更新本機專案到最新時觸發。不適用於：建立／刪除遠端 repo、單一專案的 clone（直接用 git 即可）、非 Gitea 的來源，或需要 push／改動遠端的操作。
|
description: 透過 `GITEA_TOKEN` 取得使用者有讀取權限的所有 Gitea 專案，依擁有者（owner）分組後列出讓使用者多選，再把選定擁有者底下有讀取權限的專案，於目標目錄（預設家目錄）依擁有者建立資料夾並逐一 clone；若專案已存在，則切換到 develop（再退而 master）並更新到最新。當使用者說同步 Gitea 專案、批次 clone、把某些擁有者的 repo 全抓下來、依擁有者分類 clone、批次更新本機專案到最新時觸發。不適用於：建立／刪除遠端 repo、單一專案的 clone（直接用 git 即可）、非 Gitea 的來源，或需要 push／改動遠端的操作。
|
||||||
argument-hint: "[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>] [--host <gitea 主機>] [--include-forks] [--ssh] [--yes]"
|
argument-hint: "[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>] [--host <gitea 主機>] [--include-forks] [--ssh] [--yes]"
|
||||||
---
|
---
|
||||||
|
|
||||||
# code-sync — 依擁有者批次 clone／更新 Gitea 專案
|
# sync — 依擁有者批次 clone／更新 Gitea 專案
|
||||||
|
|
||||||
五階段 skill：先做**前置設定**（解析 token、gitea 主機、目標根目錄），再**取得使用者有讀取權限的所有專案並依擁有者分組**，接著**列出所有擁有者讓使用者多選**，然後**列出選定擁有者底下有讀取權限的專案**，最後在目標根目錄**依擁有者建立資料夾並逐一 clone**；專案已存在時改為**切換到 develop（再退而 master）並更新到最新**。
|
五階段 skill：先做**前置設定**（解析 token、gitea 主機、目標根目錄），再**取得使用者有讀取權限的所有專案並依擁有者分組**，接著**列出所有擁有者讓使用者多選**，然後**列出選定擁有者底下有讀取權限的專案**，最後在目標根目錄**依擁有者建立資料夾並逐一 clone**；專案已存在時改為**切換到 develop（再退而 master）並更新到最新**。
|
||||||
|
|
||||||
@@ -22,10 +22,10 @@ argument-hint: "[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>]
|
|||||||
|
|
||||||
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
執行本 skill 前，先以 Skill 工具載入下列共用規範並全程遵守；**任一載入不到（generic plugin 未安裝）時，先詢問使用者是否安裝 generic plugin（`https://gitea.jsc.idv.tw/plugins/generic.git`），使用者不安裝則直接中斷本 skill**，不得只憑下方一行摘要繼續執行：
|
||||||
|
|
||||||
- `/jsc:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
- `/jsc-generic:spec-output`：繁體中文（台灣用語）、UTF-8（不含 BOM）無亂碼。
|
||||||
- `/jsc:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
- `/jsc-generic:spec-execution`：自動執行原則（必要決策才中斷）、不臆測／需人工確認。
|
||||||
- `/jsc:spec-gitea`：`GITEA_TOKEN` 機密保護（不 echo、遮蔽、clone 後還原乾淨 origin）、API 分頁完整讀取、host 決定順序。
|
- `/jsc-generic:spec-gitea`：`GITEA_TOKEN` 機密保護（不 echo、遮蔽、clone 後還原乾淨 origin）、API 分頁完整讀取、host 決定順序。
|
||||||
- `/jsc:spec-git-safety`：不破壞既有工作（未提交變更不強切、絕不 `reset --hard`／`clean`）、develop → master 後備、`pull --ff-only`。
|
- `/jsc-generic:spec-git-safety`：不破壞既有工作（未提交變更不強切、絕不 `reset --hard`／`clean`）、develop → master 後備、`pull --ff-only`。
|
||||||
|
|
||||||
本 skill 特有補充：
|
本 skill 特有補充：
|
||||||
|
|
||||||
@@ -51,11 +51,11 @@ argument-hint: "[--target-dir <根目錄>] [--owner <擁有者,以逗號分隔>]
|
|||||||
|
|
||||||
### A1. 確認 token
|
### A1. 確認 token
|
||||||
|
|
||||||
依 `/jsc:spec-gitea` 確認 `GITEA_TOKEN`（只輸出「已設定／未設定」，不可 echo token 本身）；**未設定** → 回報「缺少 `GITEA_TOKEN` 環境變數，無法存取 Gitea API」並停止（不要請使用者把 token 貼進對話）。
|
依 `/jsc-generic:spec-gitea` 確認 `GITEA_TOKEN`（只輸出「已設定／未設定」，不可 echo token 本身）；**未設定** → 回報「缺少 `GITEA_TOKEN` 環境變數，無法存取 Gitea API」並停止（不要請使用者把 token 貼進對話）。
|
||||||
|
|
||||||
### A2. 決定 gitea 主機
|
### A2. 決定 gitea 主機
|
||||||
|
|
||||||
依 `/jsc:spec-gitea` 的 host 決定順序：`--host` → `$GITEA_HOST` → 目前 repo 的 origin → 詢問使用者（不臆測）。主機僅取 host 部分（如 `gitea.jsc.idv.tw`），組 API base 為 `https://<host>/api/v1`。
|
依 `/jsc-generic:spec-gitea` 的 host 決定順序：`--host` → `$GITEA_HOST` → 目前 repo 的 origin → 詢問使用者（不臆測）。主機僅取 host 部分（如 `gitea.jsc.idv.tw`），組 API base 為 `https://<host>/api/v1`。
|
||||||
|
|
||||||
### A3. 決定目標根目錄
|
### A3. 決定目標根目錄
|
||||||
|
|
||||||
@@ -214,6 +214,6 @@ git -C "${dest}" fetch --all --prune
|
|||||||
|
|
||||||
| 助理 | 呼叫 |
|
| 助理 | 呼叫 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| Claude Code / Antigravity | `/jsc:code-sync`，或 `/jsc:code-sync --owner plugins --target-dir ~/work`、`/jsc:code-sync --include-forks --ssh` |
|
| Claude Code / Antigravity | `/jsc-code:sync`，或 `/jsc-code:sync --owner plugins --target-dir ~/work`、`/jsc-code:sync --include-forks --ssh` |
|
||||||
| Codex | `$code-sync`，或 `$code-sync --owner plugins --target-dir ~/work`，或用 `/skills` 選單 |
|
| Codex | `$sync`，或 `$sync --owner plugins --target-dir ~/work`，或用 `/skills` 選單 |
|
||||||
| OpenCode | 描述需求（如「用 GITEA_TOKEN 取得我有讀取權限的所有 Gitea 專案，依擁有者分組讓我多選，把選定擁有者的專案 clone 到家目錄；已存在的切到 develop／master 更新到最新」）自動觸發 |
|
| OpenCode | 描述需求（如「用 GITEA_TOKEN 取得我有讀取權限的所有 Gitea 專案，依擁有者分組讓我多選，把選定擁有者的專案 clone 到家目錄；已存在的切到 develop／master 更新到最新」）自動觸發 |
|
||||||
Reference in New Issue
Block a user