tgw-mcn-index

TGW MCN Index

You are responsible for validating and rebuilding the MCN asset relationship view. You do not modify business facts; you only derive indexes and body reading links from frontmatter. Brand-creator collaboration facts come only from COL collaboration records' brand_id、creator_id and brief_id。

Required rules

Read before execution:

• references/asset-contract.md
• references/index-contract.md
• references/index-workflow.md

When to use

• The user wants to click a brand to see collaborating creators.
• The user wants to click a creator to see collaborating brands.
• The user wants to check the brand-creator collaboration matrix.
• The user wants to check whether relationships are dangling.
• The user wants to fill Obsidian [[links]]。
• The user wants to see on the brand page ## 合作过的达人, or on the creator page see ## 合作过的品牌。
• The user wants to validate MCN assets before export.

Workflow

1. Confirm the scan directory. By default use the current project's:

tgw-data/mcn/

1. Run:

python3 skills/tgw-mcn-index/scripts/mcn_index.py --root "<项目根目录>"

1. If the user requests filling body double links, or wants to see collaboration history in the brand/creator profile, first do a dry run:

python3 skills/tgw-mcn-index/scripts/mcn_index.py --root "<项目根目录>" --fill-links --dry-run

1. After the dry-run output matches expectations, then perform the actual backfill:

python3 skills/tgw-mcn-index/scripts/mcn_index.py --root "<项目根目录>" --fill-links

By default, the actual backfill first backs up the modified source Markdown to:

tgw-data/mcn/.backups/fill-links-*/

Unless the user explicitly requests it and the project already has version control, do not use --no-backup。

1. Output the generated file paths, number of assets, number of relationships, duplicate IDs, number of dangling relationships, number of body backfill files, and backup directory.
2. If errors exist, do not pretend it is complete; list the Markdown files that must be fixed.

Generated files

tgw-data/mcn/indexes/关系索引.csv
tgw-data/mcn/indexes/关系总览.md
tgw-data/mcn/indexes/品牌-达人矩阵.csv
tgw-data/mcn/indexes/达人合作历史.csv
tgw-data/mcn/indexes/悬空关系检查.md

Prohibited

• Do not modify the generated CSV as source data.
• Do not judge collaboration facts based on body [[链接]] .
• Do not treat recommended matches as collaboration history.
• Do not accept handwritten 合作过 relationship; it can only be derived by the index from COL records as reading display.
• Do not scan the entire computer by default.
• Do not manually edit generated sections;<!-- TGRAVITY:GENERATED-START --> to <!-- TGRAVITY:GENERATED-END --> are rebuilt by the script.