Acomo

progress-all/acomo-skills/skills/acomo

by progress-all939819e2d2c21690d0e50c67b5acd6ea4e7e5336No licenseListed Oct 9, 2026Updated Oct 9, 2026

プラットフォーム利用者（acomo 上でワークフローモデルを使って開発する開発者）向け。 acomo CLI および公開 API の標準的な使い方（モデル取得・プロセス操作・認証）を案内する。 acomo 本体の内部実装は対象外。 acomo CLI を使うとき、ワークフローやプロセスの操作・モデル定義の確認を行うときに参照する。

Instructions onlySoftware Development
AI-generated overview

Guides developers through standard use of the acomo CLI and public API for workflow models and processes.

What it does
This skill explains how to use the acomo CLI and public API on the acomo workflow platform. It covers authentication, command invocation forms, listing and retrieving workflow models, and operating processes such as starting, saving, submitting, approving, rejecting, and reverting. It also points to a reference document for data structures and to CLI help for the full command list.
When to use it
Use it when working with the acomo CLI, or when you need to inspect workflow model definitions or operate workflow processes on acomo. It is intended for platform users who develop with workflow models on acomo.
Requirements
Requires the acomo CLI available on PATH, plus authentication via acomo login or the environment variables ACOMO_ACCESS_TOKEN and ACOMO_TENANT_ID, with optional ACOMO_BASE_URL. Network access to the acomo API is needed. No scripts are shipped; it is instructions only.

acomo CLI / API 標準ガイド

acomo はワークフロー管理プラットフォームです。このスキルは acomo CLI と公開 API の標準的な使い方（モデル一覧・モデル定義取得・プロセス開始・保存・提出・承認・却下・差し戻しなど）を案内します。

前提・実行環境

  • acomo CLI が実行できる環境（PATH に acomo が存在すること）を前提とします。
  • エージェントが CLI を実行する場合、リモートサンドボックス等ではローカルの ~/.acomo/config.json や環境変数が自動継承されないことがあります。CI・エージェント実行時は環境変数（ACOMO_ACCESS_TOKEN, ACOMO_TENANT_ID, ACOMO_BASE_URL）の設定を推奨します。
  • 認証未設定時も API コマンドは存在し、実行時に終了コード 2 と stderr の AUTH_REQUIRED で失敗します。その場合はユーザーに再ログイン（または環境変数設定）を促してください。

認証エラー時の扱い

認証エラー（認証未設定・401/403、終了コード 2）が出た場合は、試行錯誤で解決しようとしないこと。 速やかにユーザーにログインを促し、処理を中断する。

  • acomo login の実行、または環境変数 ACOMO_ACCESS_TOKEN, ACOMO_TENANT_ID の設定

認証

  • ローカル利用: acomo login で ~/.acomo/config.json に永続保存。
  • CI・エージェント環境: 環境変数での認証を推奨。

アクセストークンはブラウザで acomo にログインした後に入手し、CLI で指定する。

bash
# 環境変数で認証（非インタラクティブ向け）export ACOMO_ACCESS_TOKEN="your-token"export ACOMO_TENANT_ID="your-tenant-id"
# または login で保存acomo login --tenant-id <tenantId> --access-token <accessToken>
環境変数説明必須
ACOMO_ACCESS_TOKENアクセストークンYes
ACOMO_TENANT_IDテナント IDYes
ACOMO_BASE_URLAPI Base URL（省略時: https://acomo.app）No

CLI の出力は JSON です。パラメータは acomo <operationId> --help で確認する。

呼び出し形式

bash
acomo <operationId> [--option value...] [body-json]
  • path/query パラメータ → --name value 形式の named option
  • リクエストボディ → 位置引数の JSON 文字列（または stdin）
bash
# path param のみ（GET など）acomo getWorkflowModel --modelId <ID>
# query paramsacomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}'
# body のみ（POST）acomo createWorkflowModel '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'
# path param + body（PUT）acomo saveWorkflowModel --modelId <ID> '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'
# stdin から body を渡すecho '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}' | acomo createWorkflowModel

標準フロー

  1. モデル一覧: acomo listWorkflowModels で対象モデルを特定する。フィルタ例: acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}'
  2. モデル定義: acomo getWorkflowModel --modelId <ID> で definition / dataSchema / policy の JSON を取得する。
  3. プロセス操作: 必要に応じて startWorkflowProcess / saveWorkflowProcess / submitWorkflowProcess / submitWorkflowProcessWithNodeId / approveWorkflowProcess / rejectWorkflowProcess / revertWorkflowProcess を使う。自分のプロセス一覧は listMyProcesses や listProcessWithNodeActions を検討する。

主要コマンド早見

用途コマンド
モデル一覧listWorkflowModels
モデル定義取得getWorkflowModel --modelId <ID>
編集中モデルgetWorkflowModelWithLatestModelHistory --modelId <ID>
プロセス開始startWorkflowProcess --modelId <ID>
データ保存saveWorkflowProcess --processId <ID> '{"data":{...}}'
提出submitWorkflowProcess --processId <ID>
承認approveWorkflowProcess --processId <ID>
却下rejectWorkflowProcess --processId <ID>
差し戻しrevertWorkflowProcess --processId <ID> --nodeId <nodeId>
自分のプロセス一覧listMyProcesses / listProcessWithNodeActions
自分のプロセス取得getMyProcesses / getProcessWithNodeActions

プロセス操作では、タスクノードでは dataSchema に沿ったデータを saveWorkflowProcess の body の data フィールドで送る。遷移は submit / approve / reject / revert で実行する。policy の write/read に従い、現在ノードで編集可能な項目だけを扱う。

補足

  • データ構造（definition / dataSchema / policy / 条件式）の詳細は reference.md [blocked] を参照する。
  • 全コマンド一覧は acomo --help で確認する。

Source and attribution

Source:progress-all/acomo-skillsinskills/acomoat commit939819e

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More in Software Development

Playground

anthropics

Featured

Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.

Software Development37Kupdated today

M5 Onboard

anthropics

Featured

Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.

Software Development37Kupdated today

Cardputer Buddy

anthropics

Featured

Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.

Software Development37Kupdated today

Web Design Guidelines

vercel-labs

Featured

Reviews UI code against Web Interface Guidelines fetched from a remote source and reports findings as file:line entries.

Software Development32Kupdated 5 weeks ago

Vercel React Native Skills

vercel-labs

Featured

React Native and Expo best-practice rules covering list performance, animation, navigation, UI patterns, state, and monorepo setup.

Software Development32Kupdated 5 weeks ago

Vercel React Best Practices

vercel-labs

Featured

Vercel's React and Next.js performance guidelines, organized as 70 rules for writing, reviewing, and refactoring code.

Software Development32Kupdated 5 weeks ago