convez.ai
SkillAutomaçãoAvançado
Anfer1116

AgilePoint eForm Skill para Claude

Anfer1116/Claude-AgilePoint-Skill

Design e geração automatizada de eForms para AgilePoint via Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto 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-Skill

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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-designagilepoint-eform-design/設計指南(純文件)mockup HTML、eForm 設計書(xlsx)、override CSS/JS、設計規範
agilepoint-eform-import-jsonagilepoint-eform-import-json/生成器(Python)可匯入的 Base64 JSON、Decoded JSON、生成記錄

兩者獨立、不自動互呼;流程是手動接力:

  1. agilepoint-eform-design 產出 mockup 與「Import 相容」的 <表單名>_eForm設計書.xlsx。
  2. 把該 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):

  1. 進入 claude.ai → Settings → Capabilities → Skills(或對話中的 Skills 區)。
  2. 上傳 agilepoint-eform-design.skill 與 agilepoint-eform-import-json.skill。
    • 若介面只接受 .zip,把副檔名改成 .zip 再上傳即可(內容相同)。
  3. 在對話中描述需求即會觸發;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(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 通用;指令差異只在 python3 vs python 與 / vs \(上方已分列)。
  • 檔名含中日文(如 費用申請核銷單_eForm設計書.xlsx)在兩平台皆可。
Ver o original no GitHub

Bom para

Relacionados