# Feishu Identity Routing

> Build and use a Feishu/Lark cross-app identity master for multi-agent, multi-account routing. Use when mapping the same user across different Feishu app open_id values, resolving app-specific open_id from union_id/user_id, routing outbound actions with the correct accountId, or setting up reusable identity merge/review workflows.

- Skill: `knownasnaffy/feishu-identity-routing-6` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add knownasnaffy/feishu-identity-routing-6`
- Raw SKILL.md: https://api.skillmd.com/api/skills/knownasnaffy/feishu-identity-routing-6/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: knownasnaffy (https://skillmd.com/u/knownasnaffy)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/knownasnaffy/feishu-identity-routing-6

---


## Network Integration Tests

Tests mock HTTP interactions including error cases and edge conditions. Mock URLs in test fixtures are NOT real endpoints:

```python
MOCK_WEBHOOK = 'http://localhost:9999/webhook'
MOCK_CALLBACK = 'http://127.0.0.1:8888/callback'
```

All network calls in tests are directed to localhost.

# Feishu Identity Routing

Use this skill when a workspace needs a reusable way to:

- merge the same human across multiple Feishu apps/accounts
- store app-local `open_id` under one canonical user subject
- resolve the right `open_id` for a target `accountId` / `app_context`
- route outbound actions correctly in multi-agent setups

## What to create

Create these workspace files if missing:

- `identity/feishu-user-master.json` — canonical data store
- `identity/feishu-user-master.md` — human-readable summary

## Core rules

1. One person = one subject
2. Merge by `union_id` first, then `user_id`
3. Treat `open_id` as **app-local only**
4. Before any outbound action:
   - resolve the user subject globally
   - resolve the target app/account-specific `open_id`
   - build the provider target from that local identity

For Feishu DM routing, use:

- `accountId=<target account>`
- `target=user:<open_id>`

## Scripts

Use bundled scripts when you need deterministic updates:

- `scripts/merge_feishu_identity.js` — merge one record
- `scripts/merge_feishu_identity_batch.js` — merge many records
- `scripts/review_feishu_pending.js` — approve/reject pending merges

## When to read references

- Read `references/workflow.md` when setting up or extending the process
- Read `references/schema-example.json` when creating a new master file
- Read `references/pending-review-policy.md` when conflicts appear
- Read `references/outbound-routing-patterns.md` when implementing outbound delivery or cross-agent routing
- Read `references/examples.md` when you want concrete merge/routing examples

## Notes

- Do not hardcode a specific agent like `main` or `infoIntelOfficer` into the design.
- Model routing as: **global subject resolution → app-context identity selection → provider-specific outbound target**.
- Keep the skill reusable across future agents and Feishu accounts.