req-fn-app-actor-definition

Define system actors and create an actor definition document for authorization design.

Updated May 18, 2026
One-click install
npx skills add https://github.com/ABLER-Digital-Services/ai-guild --skill req-fn-app-actor-definition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: req-fn-app-actor-definition
Source: https://github.com/ABLER-Digital-Services/ai-guild/tree/main/skills/req-fn-app-actor-definition
Command: npx skills add https://github.com/ABLER-Digital-Services/ai-guild --skill req-fn-app-actor-definition

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

認可(アクセス制御)設計に必要な「誰が何にアクセスするか」を、アクター(人間・外部システム)単位で抜け漏れなく整理できていない状態を解消します。

Core Features & Use Cases

  • アクター洗い出し: 人間アクターと外部システムアクターを整理し、階層関係やマルチテナント有無まで前提化します。
  • アクター詳細定義: 役割、許可(できること)、禁止(できないこと)、認証方法、利用環境を明確に記述します。
  • レビューチェック: 網羅性、名称の適切性、記載の具体性、認証情報、アクター間の関係が妥当かを検証します。

使いどころ例: 業務フローや機能一覧を作る前に、対象システムに関わる利用者種別・ロール・権限を整理して、後続の認可設計に接続するための前提ドキュメントが欲しい場合。

Quick Start

アクター定義書を作成して、アクター一覧と各アクターの許可/禁止/認証方法/利用環境をテンプレートに沿ってまとめてください。

Frequently Asked Questions about req-fn-app-actor-definition

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is actor definition for access control design?

Actor definition for access control design identifies human users and external systems to establish clear permission boundaries, role hierarchies, and authentication methods. It creates a foundational document ensuring no actor's permissions are overlooked in subsequent authorization design.

How do I define system actors for authorization requirements?

To define system actors for authorization requirements, you create an actor definition document using a template. You list all human and external system actors, then specify their roles, permitted actions, prohibited actions, authentication methods, and usage environments.

Does actor modeling handle multi-tenant role hierarchy structures?

Yes, actor modeling handles multi-tenant role hierarchy structures. The actor definition process requires you to identify and document hierarchical relationships and multi-tenant presence upfront, ensuring the access control design accommodates complex organizational structures.

What is the best way to document actor permissions and authentication methods?

The best way to document actor permissions and authentication methods is template-driven documentation. A structured template ensures you consistently capture permitted actions, prohibited actions, authentication details, and usage environments for every human and external system actor.

When do I need to create an actor definition document before authorization design?

You need to create an actor definition document before designing business flows or feature lists. It serves as a prerequisite to organize user types, roles, and permissions, ensuring the subsequent access control design is built on a validated foundation.

Why does my authorization design miss external system access boundaries?

Your authorization design misses external system access boundaries when actor discovery is incomplete. Creating a comprehensive actor definition document ensures both human users and external system integrations are explicitly modeled with their specific permission boundaries and authentication requirements.