AgilePoint eForm Skill para Claude
Anfer1116/Claude-AgilePoint-Skill
Design e geração automatizada de eForms para AgilePoint via Claude
Ver no GitHubConjunto de dois skills complementares para transformar requisitos de clientes em formulários eForm importáveis no AgilePoint. O primeiro gera mockups HTML e especificações de design; o segundo converte esses artefatos em JSON Base64 pronto para importação, com suporte a HTML bruto, JavaScript customizado e estilos dinâmicos.
Instalação
npx convez-ai Anfer1116/Claude-AgilePoint-Skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Converter wireframes de formulários em eForm JSON importável
- Gerar mockups HTML e especificações de design (XLSX) a partir de requisitos
- Injetar JavaScript customizado e CSS override em formulários do AgilePoint
- Automatizar o pipeline design → especificação → implementação de eforms
Veredito

Skill bem estruturado e modular para automação completa do ciclo de vida de eforms no AgilePoint. Requer Python 3.9+ e setup inicial, mas oferece integração fluida com Claude Chat e Claude Code em ambos os sistemas operacionais.
README
A tradução para o português deste README ainda está na fila.
AgilePoint eForm Skills(Claude Chat / Claude Code 通用)
兩個搭配使用的 Agent Skill,從客戶畫面需求 → mockup+設計書 → 可匯入 AgilePoint 的 eForm JSON。 同一份 Skill 格式可同時用於 Claude Chat(claude.ai)與 Claude Code,並可在 macOS / Windows 執行。
| Skill | 資料夾 | 角色 | 主要產出 |
|---|---|---|---|
| agilepoint-eform-design | agilepoint-eform-design/ | 設計指南(純文件) | mockup HTML、eForm 設計書(xlsx)、override CSS/JS、設計規範 |
| agilepoint-eform-import-json | agilepoint-eform-import-json/ | 生成器(Python) | 可匯入的 Base64 JSON、Decoded JSON、生成記錄 |
兩者獨立、不自動互呼;流程是手動接力:
agilepoint-eform-design產出 mockup 與「Import 相容」的<表單名>_eForm設計書.xlsx。- 把該 xlsx + 範本餵給
agilepoint-eform-import-json/scripts/main.py產出 import JSON。
本版重點(2026-06)
import-json 生成器新增/修正(細節見 agilepoint-eform-import-json/CHANGELOG.md):
- RawHtml 內容:讀「RawHtml 內容」分頁,寫入 RawHtml 的
FieldText(過去匯入後空白)。 - eForm JavaScript 注入:讀「eForm JavaScript」分頁,合併注入
agileForm.formJS。 - Heading 樣式:以 Remarks
Heading=h3; BackColor=#1B3A6B; ForeColor=#FFFFFF套用。 - 子表單 CSS selector:子表單 override CSS 一律用
[controlholdername="<DataName>"](不是name)。 - 可攜性:命名標準改為自我包含查找,打包後不論 cwd 都找得到。
取得專案
方式 A:git clone(建議)
git clone git@github.com:Anfer1116/Claude-AgilePoint-Skill.git
cd Claude-AgilePoint-Skill
若沒有設定 SSH 金鑰,改用 HTTPS:
git clone https://github.com/Anfer1116/Claude-AgilePoint-Skill.git
方式 B:下載 ZIP
GitHub 頁面 → Code → Download ZIP,解壓後即得下方安裝步驟所需的兩個資料夾與 .skill 檔。
取得後,依下方選擇 Claude Chat 或 Claude Code 的安裝方式。
安裝:Claude Chat(claude.ai)
Skill 以資料夾(含 SKILL.md)為單位,上傳時用 zip。本包已附 .skill(即 zip):
- 進入 claude.ai → Settings → Capabilities → Skills(或對話中的 Skills 區)。
- 上傳
agilepoint-eform-design.skill與agilepoint-eform-import-json.skill。- 若介面只接受
.zip,把副檔名改成.zip再上傳即可(內容相同)。
- 若介面只接受
- 在對話中描述需求即會觸發;import-json 的 Python 會在內建程式碼沙箱執行(已含
openpyxl需求)。
.skill/.zip內最上層是與技能同名的資料夾,其下為SKILL.md與隨附檔(standards、assets、scripts…),皆已自我包含。
安裝:Claude Code
把資料夾放到 skills 目錄即可(個人層對所有專案生效,專案層只對該專案生效):
macOS / Linux(bash/zsh)
# 個人層(建議)
mkdir -p ~/.claude/skills
cp -R agilepoint-eform-design ~/.claude/skills/
cp -R agilepoint-eform-import-json ~/.claude/skills/
# 或專案層
mkdir -p <你的專案>/.claude/skills
cp -R agilepoint-eform-design agilepoint-eform-import-json <你的專案>/.claude/skills/
Windows(PowerShell)
# 個人層(建議)
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills" | Out-Null
Copy-Item -Recurse -Force .\agilepoint-eform-design "$env:USERPROFILE\.claude\skills\"
Copy-Item -Recurse -Force .\agilepoint-eform-import-json "$env:USERPROFILE\.claude\skills\"
放好後重開 Claude Code;描述需求即會自動帶出對應 skill,或用 /agilepoint-eform-design、/agilepoint-eform-import-json 觸發。
執行需求(import-json)
- Python 3.9+,相依:
openpyxl - 安裝相依:
- macOS/Linux:
python3 -m pip install -r agilepoint-eform-import-json/scripts/requirements.txt - Windows:
python -m pip install -r agilepoint-eform-import-json\scripts\requirements.txt
- macOS/Linux:
生成指令
macOS / Linux(bash/zsh):
python3 agilepoint-eform-import-json/scripts/main.py \
--template agilepoint-eform-import-json/assets/eFormTemplate.base64.json \
--html <mockup>.html \
--spec <表單名>_eForm設計書.xlsx \
--out-base64 output_import.json \
--out-decoded output_decoded.json \
--out-log generation_log.json
Windows(PowerShell):
python agilepoint-eform-import-json\scripts\main.py `
--template agilepoint-eform-import-json\assets\eFormTemplate.base64.json `
--html <mockup>.html `
--spec <表單名>_eForm設計書.xlsx `
--out-base64 output_import.json `
--out-decoded output_decoded.json `
--out-log generation_log.json
- 命名標準會自動套用(隨附於
agilepoint-eform-import-json/standards/);要指定其他位置才需加--naming-standard <路徑>。 - 只有在
generation_log.json的validation.valid為true時才交付output_import.json。
跨平台注意
- 所有檔案讀寫皆固定 UTF-8(讀
utf-8-sig、寫utf-8),不依賴系統預設編碼 → Windows 不會亂碼。 - 路徑一律用
pathlib,Mac/Windows 通用;指令差異只在python3vspython與/vs\(上方已分列)。 - 檔名含中日文(如
費用申請核銷單_eForm設計書.xlsx)在兩平台皆可。