Dokumenty i biuro · Integracja z narzędziem
share
/share
Udostępnia lub cofa udostępnienie aplikacji Microsoft użytkownikom przez CLI ms app share i ms app unshare.
- Autor
- microsoft ↗
- Repozytorium
- managed-apps ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.10.2026
Ocena i bezpieczeństwo
100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 09.10.2026, bez odwołań do wycofanych modeli i API.
Licencja
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Udostępnia lub cofa udostępnienie aplikacji Microsoft użytkownikom przez CLI ms app share i ms app unshare.
Oryginalny opis (EN)
Shares (or unshares) a Microsoft App with users via `ms app share` / `ms app unshare`. Use when updating app access control.
Jak działa
- Workflow
- Edge Cases
Sekcje z nagłówków SKILL.md, w oryginale · 91 linii, 507 słów
Podgląd SKILL.md
---
name: share
description: Shares (or unshares) a Microsoft App with users via `ms app share` / `ms app unshare`. Use when updating app access control.
user-invocable: true
allowed-tools: Read, Grep, Glob, Bash, AskUserQuestion
model: sonnet
---
**📋 Shared Instructions: [shared-instructions.md](${CLAUDE_PLUGIN_ROOT}/shared/shared-instructions.md)** — Cross-cutting concerns. **Always confirm before share/unshare.**
# Share / Unshare
Adds or removes user access to the app in the current directory. The CLI resolves emails via Microsoft Graph; entries that don't resolve are returned as warnings (the RP call still succeeds for the resolved entries).
## Workflow
1. Memory Bank → 2. Verify Project + Env → 3. Mode (share / unshare) → 4. Collect Emails → 5. Confirm → 6. Run → 7. Surface Partial-Success Envelope
---
### Step 1: Check Memory Bank
Read `memory-bank.md` for app slug, GUID, and environment.
### Step 2: Verify Project + Env
```bash
test -f ms.config.json || { echo "Not in a Microsoft App workspace."; exit 1; }
BIN=ms
$BIN auth status # must report the expected UPN
```
### Step 3: Mode
Ask whether the user wants to **share** (add access) or **unshare** (remove access). Default to share unless the prompt obviously indicates removal.
### Step 4: Collect Emails
Accept a comma-separated email list. Validate basic shape (`user@domain`) before passing through; don't try to resolve them yourself — `ms` handles Graph resolution and will return warnings for unresolved entries.
If the user passes Object GUIDs (already-resolved principals), pass them through as-is — the CLI accepts both forms.
### Step 5: Confirm
Show the user exactly what will run, then ask for confirmation:
> "About to **share** `<app-name>` with: `alice@contoso.com, bob@contoso.com`. Confirm?"
Wait for explicit yes. Never auto-proceed — ACL changes affect production users.
### Step 6: Run
**Share:**
```bash
$BIN app share "alice@contoso.com,bob@contoso.com"
```
**Unshare:**
```bash
$BIN app unshare "alice@contoso.com,bob@contoso.com"
```
The command reads the app ID from `ms.config.json`.
### Step 7: Surface Partial-Success Envelope
The CLI returns a JSON envelope with `partialFailure: boolean` and `warnings: []`. When `partialFailure: true`:
- The RP call succeeded — share state is updated for resolved users.
- Warnings list the unresolved entries (typo'd email, account doesn't exist in the tenant, Graph couldn't find them, etc.).
Print warnings verbatim and ask the user whether to re-run with corrected entries:
```
Share completed with warnings:
- 'bob@contso.com' could not be resolved (Graph returned 404).
- 'charlie@partner.com' is not a member of this tenant.
Share state updated for: alice@contoso.com (1 of 3 resolved).
Would you like to retry the 2 unresolved entries with corrections?
```
If the user confirms, loop back to Step 4 with the corrected list. Don't retry automatically — typos and tenant-membership issues need human resolution.
---
## Edge Cases
| Situation | Action |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| User passes a single email | Run as-is; the envelope still applies (just with one entry). |
| User passes a mix of emails and Object GUIDs | Pass through as one comma-separated list — the CLI accepts both. |
| `ms app share` returns non-zero (not a partial-failure envelope) | A hard error (auth, env, app-not-found). Surface verbatim and STOP. Do not retry. |
| User says "share with everyone" | Decline — there is no "everyone" semantic. Ask for an explicit list. |
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · microsoft/managed-apps | 100 | MIT |
| ClickHouse/ClickHouse | 100 | Apache-2.0 |
| dtyq/magic | 100 | Apache-2.0 |
| spencerneutron/Synapse | 100 | MIT |
| microsoft/Copilot-Managed-Runtime | 100 | MIT |
| rarexlabs/p11-public | 100 | MIT |
| rarexlabs/p11-public | 100 | MIT |
| FYClamityDestiny/vetted | 90 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki f8b140116a9f (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100share-link
Tworzy, wyświetla i cofa linki udostępniania aplikacji Microsoft dla całej organizacji, zamiast nazwanych osób. - 100share-link
Tworzy, wyświetla i odwołuje linki udostępnienia aplikacji Microsoft dla całego najemcy, zamiast nadawać dostęp konkretnym osobom. - 100grayspar
Wdraża aplikacje w Grayspar i udostępnia je wybranym osobom przez CLI, z zachowaniem danych i zmiennych środowiska. - 100key-shares
Obsługuje i diagnozuje udziały (key shares), czyli klucze udostępnione przez właścicieli w realmie innym osobom: tabele key_shares i key_share_notices, trasy, stany active i suspended oraz powody zawieszenia i wznowienia. - 100linshare
Udostępnia pliki przez LinShare: wysyła je e-mailem, cofa udziały, pobiera otrzymane pliki i zarządza grupami roboczymi. - 95delete-app
Usuwa aplikację Microsoft przez ms app delete, zawsze po wyraźnym potwierdzeniu użytkownika.