Communitygithub.com

jeremylongshore/tons-of-skills-marketplace

使用 AppFolio 自动化租户管理和租赁运营。

tons-of-skills-marketplace 是什么?

该技能通过 AppFolio Stack API 自动完成维护工单的完整生命周期管理。它支持从租户提交维护请求开始,创建工单、分配供应商、跟踪维修进度,并在完成后记录成本并关闭工单。该技能适用于希望简化物业管理中维护流程的开发者和运营团队,提供可重复的自动化工作流。它主要支持 AppFolio Stack API,并包含必要的错误处理、幂等性支持和安全最佳实践。用户需具备 AppFolio 沙箱环境和最低权限服务身份。

兼容平台✓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 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

AppFolio — 工单与维护

概述

通过 AppFolio Stack API 管理维护工单的完整生命周期。 当租户提交维护请求时,需要使用此工作流;当您需要为未处理的工单指派供应商、跨物业跟踪维修进度,或通过成本记录关闭已完成的任务时,也请使用此工作流。这是二级工作流——如需查看物业仪表盘和租赁信息,请参见 appfolio-core-workflow-a。

前提条件

  • 已验证的 AppFolio 合约和沙箱组合,其中包含合成物业、单元、供应商和工单记录;请勿在已占用的生产单元上测试维护自动化。
  • 最低权限的服务身份,支持创建/关闭操作的幂等性,以及针对安全关键维护的已批准上报路径。
  • 数据最小化策略:仅存储和传输执行工作所需的维护事实,切勿在通用供应商备注或日志中存储租户偏好、访问密码或详细的入住信息。

操作说明

步骤 1:根据维护请求创建工单

const workOrder = await client.workOrders.create({
  property_id: 'prop_4821',
  unit_id: 'unit_12B',
  category: 'plumbing',
  priority: 'high',
  description: 'Synthetic plumbing fixture leak reported in sandbox unit',
  requested_by: 'tenant_8934',
  due_date: '2026-04-10',
});
console.log(`Work order ${workOrder.id} created — status: ${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: 'Confirm scheduled appointment through the approved work-order channel.',
});
console.log(`Assigned to ${assignment.vendor_name} on ${assignment.scheduled_date}`);

步骤 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} (due ${wo.due_date})`)
);

步骤 4:关闭工单并记录成本

const closed = await client.workOrders.close(workOrder.id, {
  resolution: 'Replaced P-trap and tightened supply line. No further leaks.',
  labor_cost: 175.00,
  materials_cost: 42.50,
  completed_date: '2026-04-08',
  attachments: ['receipt_plumb_0408.pdf'],
});
console.log(`Closed #${closed.id} — total cost: $${closed.total_cost}`);

错误处理

问题原因修复
401 UnauthorizedAPI 凭证已过期或无效在 Stack 仪表板中刷新 client_id/secret
404 Work Order Not Found工单 ID 错误或已被删除使用 workOrders.list() 验证 ID
422 Missing required fields缺少类别或 property_id根据架构包含所有必填字段
409 Conflict工单已关闭在尝试关闭前检查状态
429 Rate Limited超过 120 次请求/分钟添加指数退避,基本延迟 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".

相关技能