Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

AppFolio でのテナント管理とリース業務を自動化します。

tons-of-skills-marketplace とは?

このスキルは、AppFolio の Stack API を通じてメンテナンス作業指示(Work Order)のライフサイクル全体を管理するためのものです。テナントがメンテナンス依頼を提出した際、ベンダーを未処理の作業指示に割り当てる際、物件全体の修理進捗を追跡する際、または完了したジョブをコスト記録と共にクローズする際に使用します。このワークフローは二次的なものであり、物件ダッシュボードやリース業務には `appfolio-core-workflow-a` を参照します。事前に、AppFolio の契約と仮想物件、ユニット、ベンダー、作業指示レコードを含むサンドボックス ポートフォリオが用意されていることが必須です。Idempotency キーによる安全な作成/クローズ操作、最小権限のサービス ID、および安全上重要なメンテナンスのための承認済みエスカレーションパスが必要です。データ最小化ポリシーに従い、作業遂行に必要なメンテナンス情報のみを保存・送信し、テナントの嗜好やアクセスコード、詳細な居住情報を汎用的なベンダーノートやログに含めないようにします。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/plugins/saas-packs/appfolio-pack/skills/appfolio-core-workflow-b

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AppFolio — 作業指示とメンテナンス

概要

AppFolio の Stack API を通じて、メンテナンス作業指示のライフサイクル全体を管理します。 次のような場合にこのワークフローを使用します:テナントがメンテナンス依頼を提出したとき、ベンダーを未処理の作業指示に割り当てるとき、物件全体の修理進捗を追跡するとき、または完了したジョブをコスト記録と共にクローズするとき。これは二次的なワークフローです。物件ダッシュボードやリース業務については、appfolio-core-workflow-a を参照してください。

前提条件

  • 検証済みの AppFolio 契約、および仮想的な物件、ユニット、ベンダー、作業指示レコードを含むサンドボックス ポートフォリオ。占有中の本番ユニットに対してメンテナンス自動化をテストしないでください。
  • 最小権限のサービス ID、作成/クローズ操作に対するべき等性(idempotency)のサポート、および安全上重要なメンテナンスに対する承認済みエスカレーションパス。
  • データ最小化ポリシー:作業の実行に必要なメンテナンス情報のみを保存・送信し、テナントの嗜好、アクセスコード、または詳細な居住情報を汎用的なベンダーノートやログに含めないこと。

手順

ステップ 1: メンテナンス依頼から作業指示を作成する

const workOrder = await client.workOrders.create({
  property_id: 'prop_4821',
  unit_id: 'unit_12B',
  category: 'plumbing',
  priority: 'high',
  description: 'サンドボックスユニットで報告された仮想的な配管器具の漏れ',
  requested_by: 'tenant_8934',
  due_date: '2026-04-10',
});
console.log(`作業指示 ${workOrder.id} が作成されました — ステータス: ${workOrder.status}`);

ステップ 2: ベンダーを割り当てる

const assignment = await client.workOrders.assign(workOrder.id, {
  vendor_id: 'vendor_plumb_01',
  scheduled_date: '2026-04-08',
  time_window: '09:00-12:00',
  notes: '承認された作業指示チャネルを通じて予約の確認を行ってください。',
});
console.log(`${assignment.scheduled_date} に ${assignment.vendor_name} に割り当てられました`);

ステップ 3: 作業指示のステータスを追跡する

const open = await client.workOrders.list({
  property_id: 'prop_4821',
  status: ['open', 'in_progress', 'scheduled'],
  sort: 'priority_desc',
});
open.items.forEach(wo =>
  console.log(`#${wo.id} [${wo.priority}] ${wo.category} — ${wo.status} (期限 ${wo.due_date})`)
);

ステップ 4: 作業指示をコスト記録と共にクローズする

const closed = await client.workOrders.close(workOrder.id, {
  resolution: 'Pトラップを交換し、給水ラインを締め付けました。それ以降漏れはありません。',
  labor_cost: 175.00,
  materials_cost: 42.50,
  completed_date: '2026-04-08',
  attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`#${closed.id} をクローズ — 合計費用: $${closed.total_cost}`);

エラー処理

問題原因修正方法
401 UnauthorizedAPI 資格情報の期限切れまたは無効Stack ダッシュボードで client_id/secret を更新
404 Work Order Not Found間違った作業指示 ID、または既に削除されているworkOrders.list() で ID を確認
422 Missing required fieldsCategory または property_id が欠落スキーマに従って必須フィールドをすべて含める
409 Conflict作業指示が既にクローズされているクローズ試行前にステータスを確認
429 Rate Limited120 リクエスト/分 を超過ベース遅延 1 秒の指数バックオフを追加

出力

成功すると、作業指示が作成され、スケジュールされたサービス時間枠でベンダーに割り当てられ、コスト記録と解決メモと共にクローズされます。物件管理者は、依頼から完了までの完全な監査証跡を取得できます。

例

サンドボックス配管ワークフローでは、安定したべき等性キーで 1 つの仮想的な作業指示を作成し、サンドボックスベンダーを割り当て、ステータス遷移前にそのステータスを読み戻します。機密性のないテスト用領収書のみを添付し、その後一度だけ作業指示をクローズして、合計と監査レコードを確認します(テナントやアクセスの詳細はログに記録しません)。同じリクエストを再生して、重複する作業指示と重複するコスト記録が拒否されることを証明します。ベンダーの割り当て、安全分類、以前の状態、またはクローズ結果が不明確な場合は、作業指示をオープンのままにし、承認された物件管理者にルーティングして確認を依頼します。

リソース

次のステップ

認証設定とページネーションヘルパーについては appfolio-sdk-patterns を参照してください。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page for positioning, plan a conversion-optimized page layout, or design a launch page. Examples: "landing page for product launch", "conversion-optimized layout for SaaS

jeremylongshore/tons-of-skills-marketplace

Use when asked to design growth-optimized landing pages, activation funnel layouts, or experiment-friendly page structures. Examples: "growth-optimized landing", "activation funnel layout", "A/B testable page

jeremylongshore/tons-of-skills-marketplace

Use when asked to structure a landing page, design page layout for conversion, or plan landing page information architecture. Examples: "landing page structure for SaaS", "conversion-optimized layout

jeremylongshore/tons-of-skills-marketplace

Generate polished demo videos from a single prompt. Use when the user asks to create a demo video, product walkthrough, feature showcase, or animated presentation. Trigger with "make a demo video", "create a product video", "demo walkthrough", or "feature showcase video".

jeremylongshore/tons-of-skills-marketplace

Track cryptocurrency portfolio with real-time valuations, allocation analysis, and P&L tracking. Use when checking portfolio value, viewing holdings breakdown, analyzing allocations, or exporting portfolio data. Trigger with phrases like "show my portfolio", "check crypto holdings", "portfolio allocation", "track my crypto", or "export portfolio".

jeremylongshore/tons-of-skills-marketplace

Runs the full release workflow for the current project. Commits any uncommitted changes, pushes to remote, creates and merges a PR if on a feature branch, determines the next semver version from conventional commits, creates an annotated git tag and GitHub release with generated notes, cleans up merged branches, and returns to a clean main. Use when the user says promote, ship, release, commit and push, tag and release, or get back to main.

jeremylongshore/tons-of-skills-marketplace

Agent skill at plugins/productivity/content-multiplier/skills/channel-formats/SKILL.md

jeremylongshore/tons-of-skills-marketplace

Operate an evidence-backed editorial queue, balance topic and format coverage, schedule approved drafts, and reconcile backlog state with the publishing system. Use when choosing or scheduling the next blog work. Trigger with "show the editorial calendar" or "pick the next topic".

jeremylongshore/tons-of-skills-marketplace

Configure CI/CD pipeline for AppFolio property management integrations. Trigger: "appfolio CI".

jeremylongshore/tons-of-skills-marketplace

Diagnose and fix common AppFolio API integration errors. Trigger: "appfolio error".

jeremylongshore/tons-of-skills-marketplace

Build property management dashboard with AppFolio API data. Trigger: "appfolio property dashboard".

jeremylongshore/tons-of-skills-marketplace

Collect AppFolio API debug evidence for support tickets. Trigger: "appfolio debug".

jeremylongshore/tons-of-skills-marketplace

Deploy AppFolio integration service to cloud infrastructure. Trigger: "deploy appfolio".

jeremylongshore/tons-of-skills-marketplace

Query AppFolio properties, units, and tenants via REST API. Trigger: "appfolio hello world".

jeremylongshore/tons-of-skills-marketplace

Configure AppFolio Stack API authentication with OAuth 2.0. Use when setting up property management API access, registering as an AppFolio Stack partner, or configuring client credentials for API calls. Trigger: "install appfolio", "setup appfolio", "appfolio auth", "appfolio API key".

jeremylongshore/tons-of-skills-marketplace

Set up local development for AppFolio property management API integration. Trigger: "appfolio local dev".

jeremylongshore/tons-of-skills-marketplace

Production readiness checklist for AppFolio integrations. Trigger: "appfolio production checklist".

jeremylongshore/tons-of-skills-marketplace

Handle AppFolio API rate limits with throttling and backoff. Trigger: "appfolio rate limit".

jeremylongshore/tons-of-skills-marketplace

Reference architecture for AppFolio property management integration. Trigger: "appfolio architecture".

jeremylongshore/tons-of-skills-marketplace

Apply production-ready patterns for AppFolio REST API integration. Trigger: "appfolio patterns".

関連スキル