diff --git a/wiki/concepts/CodeOverConfiguration.md b/wiki/concepts/CodeOverConfiguration.md new file mode 100644 index 00000000..6b4ef00b --- /dev/null +++ b/wiki/concepts/CodeOverConfiguration.md @@ -0,0 +1,70 @@ +--- +title: "CodeOverConfiguration" +type: concept +tags: [cms, development, best-practices] +last_updated: 2026-05-01 +--- + +## Definition + +CodeOverConfiguration is a CMS development principle requiring that all structural changes — custom post types, taxonomies, fields, blocks, and behavioral settings — be registered in code rather than created through the admin UI. Configuration that affects behavior is also stored in code (not the database). + +## Core Principle + +> "Custom post types, taxonomies, fields, and blocks are registered in code — never created through the admin UI alone." + +## WordPress Application + +| What | Where to register | +|------|-------------------| +| Custom post types | `functions.php` → `register_post_type()` | +| Custom taxonomies | `functions.php` → `register_taxonomy()` | +| ACF field groups | `acf-json/` directory (synced) | +| ACF blocks | `functions.php` → `acf_register_block_type()` | +| Gutenberg blocks | `block.json` + JS registration | +| Theme settings | `wp-config.php` or `functions.php` | + +### Example: Post type in code + +```php +add_action( 'init', function () { + register_post_type( 'case_study', [ + 'public' => true, + 'show_in_rest' => true, + 'supports' => [ 'title', 'editor', 'thumbnail', 'excerpt' ], + ] ); +} ); +``` + +## Drupal Application + +| What | Where to store | +|------|---------------| +| Content types | YAML config export (`drush cex`) | +| Field definitions | YAML config in `config/install/` | +| Custom modules | PHP code + YAML routing/permissions | +| Blocks | PHP attribute-based plugins (Drupal 10+) | +| Views | YAML config export | + +## Why It Matters + +- **Version control**: All structural changes are tracked in Git +- **Reproducibility**: A fresh environment gets the same structure from a deploy script +- **Team consistency**: No one accidentally changes a field label in production +- **Deployment safety**: Config changes go through CI/CD, not manual admin actions + +## Anti-patterns + +- ❌ Creating post types via the WordPress admin UI without code equivalent +- ❌ Storing CMS settings that affect behavior in the database instead of code +- ❌ Modifying contrib module/theme files directly instead of using hooks/overrides + +## Related Concepts + +- [[ContentModel-first]] — the companion principle: define the model first, then implement +- [[GitWorkflow]] — version control makes code-as-config viable +- [[WordPress]] — WordPress-specific code registration patterns +- [[Drupal]] — Drupal-specific YAML configuration export workflow + +## Sources +- [[engineering-cms-developer]] diff --git a/wiki/concepts/ContentModel-first.md b/wiki/concepts/ContentModel-first.md new file mode 100644 index 00000000..11e8746e --- /dev/null +++ b/wiki/concepts/ContentModel-first.md @@ -0,0 +1,48 @@ +--- +title: "ContentModel-first" +type: concept +tags: [cms, development, methodology] +last_updated: 2026-05-01 +--- + +## Definition + +ContentModel-first is a CMS development principle that mandates: **before writing any theme or template code, the fields, content types, and editorial workflow must be fully defined and locked**. This applies to both WordPress and Drupal development. + +## Core Principle + +> "Content model first. Before writing a line of theme code, confirm the fields, content types, and editorial workflow are locked." + +## Application + +### WordPress +- Define custom post types, taxonomies, and ACF field groups before building templates +- Lock down field names, types, validation rules +- Plan display variants (teaser, full, card, hero) + +### Drupal +- Define content types, paragraph types, vocabulary terms, and entity references first +- Use Paragraphs or Layout Builder for flexible editorial content +- Export all configuration to YAML before writing custom modules + +## Why It Matters + +- **Prevents rework**: Template code rarely needs to change when the data model is stable +- **Reduces editor confusion**: When fields are well-named and organized, editorial UX improves +- **Enables parallel work**: Front-end developers and content strategists can work simultaneously once the model is agreed +- **Improves maintainability**: Adding a new field is a data modeling decision, not a template hotfix + +## Anti-patterns + +- ❌ Building templates for undefined fields +- ❌ Creating post types through the admin UI without documenting the schema +- ❌ Changing field names after templates reference them + +## Related Concepts + +- [[CodeOverConfiguration]] — the companion principle: register everything in code +- [[LayoutBuilder]] — Drupal's tool for implementing flexible content models +- [[GutenbergBlockEditor]] — WordPress's tool for flexible content editing + +## Sources +- [[engineering-cms-developer]] diff --git a/wiki/entities/Drupal.md b/wiki/entities/Drupal.md new file mode 100644 index 00000000..a7c3ede3 --- /dev/null +++ b/wiki/entities/Drupal.md @@ -0,0 +1,85 @@ +--- +title: "Drupal" +type: entity +tags: [cms, php, enterprise, open-source] +last_updated: 2026-05-01 +--- + +## Overview + +Drupal is an open-source enterprise CMS/CMF written in PHP, known for its flexibility and scalability. Primary use cases: enterprise platforms, complex content models, government/digital transformation projects, multilingual sites. + +## Aliases +- Drupal CMS +- Drupal CMF + +## Key Characteristics + +- **Complex content modeling**: Paragraphs, entity references, media library, field API, display modes +- **Layout Builder**: Per-node layouts, layout templates, custom section and component types +- **Configuration in code**: `drush cim/cex` (config import/export) — all config in YAML files +- **Custom modules**: PHP attributes (Drupal 10+), hook system, routing YAML, service container +- **Twig templating**: Template layer with preprocess hooks for data transformation +- **Composer workflow**: `composer require`, patches, version pinning, `drush pm:security` +- **Multilingual**: TMGMT translation module, language negotiation built-in + +## Drupal Coding Patterns + +### Custom Module Structure + +``` +my_module/ +├── my_module.info.yml +├── my_module.module +├── my_module.routing.yml +├── my_module.services.yml +├── my_module.permissions.yml +├── my_module.links.menu.yml +└── src/ + ├── Controller/ + ├── Form/ + ├── Plugin/Block/ + └── EventSubscriber/ +``` + +### Custom Block Plugin (Drupal 10+ PHP Attributes) + +```php +#[Block( + id: 'my_custom_block', + admin_label: new TranslatableMarkup('My Custom Block'), +)] +class MyBlock extends BlockBase { + public function build(): array { + return [ + '#theme' => 'my_custom_block', + '#attached' => ['library' => ['my_module/my-block']], + '#cache' => ['max-age' => 3600], + ]; + } +} +``` + +### Hook Implementation + +```php +function my_module_node_access(EntityInterface $node, $op, AccountInterface $account) { + if ($node->bundle() === 'case_study' && $op === 'view') { + return $account->hasPermission('view case studies') + ? AccessResult::allowed()->cachePerPermissions() + : AccessResult::forbidden()->cachePerPermissions(); + } + return AccessResult::neutral(); +} +``` + +## Connections + +- [[CMSDeveloper]] uses Drupal as a primary CMS platform +- [[ContentModel-first]] applies to Drupal content modeling before theme code +- [[CodeOverConfiguration]] — Drupal config exported to YAML, not UI +- [[LayoutBuilder]] is a Drupal-specific flexible content building system +- [[TwigTemplating]] is Drupal's template engine + +## Sources +- [[engineering-cms-developer]] diff --git a/wiki/entities/WordPress.md b/wiki/entities/WordPress.md new file mode 100644 index 00000000..fe166a96 --- /dev/null +++ b/wiki/entities/WordPress.md @@ -0,0 +1,73 @@ +--- +title: "WordPress" +type: entity +tags: [cms, php, open-source] +last_updated: 2026-05-01 +--- + +## Overview + +WordPress is an open-source CMS (Content Management System) written in PHP, powering 40%+ of all websites globally. Primary use cases: blogs, brochure sites, WooCommerce e-commerce stores, headless CMS with REST/GraphQL API. + +## Aliases +- WP +- WordPress.org (self-hosted vs wordpress.com) + +## Key Characteristics + +- **Editing simplicity**: Gutenberg block editor (5.0+), intuitive for non-technical editors +- **Plugin ecosystem**: 60,000+ plugins via wordpress.org repository +- **Theme system**: Child themes (never modify parent directly), code-first registration of post types/taxonomies/fields +- **Configuration**: Settings in `wp-config.php` or code — not the database +- **Custom post types & taxonomies**: Registered in code via `register_post_type()` / `register_taxonomy()`, not UI +- **ACF Pro**: Advanced Custom Fields plugin for structured content; field groups synced via ACF JSON + +## WordPress Coding Patterns + +### Register Custom Post Type (code, not UI) + +```php +add_action( 'init', function () { + register_post_type( 'case_study', [ + 'labels' => [ + 'name' => 'Case Studies', + 'singular_name' => 'Case Study', + ], + 'public' => true, + 'has_archive' => true, + 'show_in_rest' => true, + 'menu_icon' => 'dashicons-portfolio', + 'supports' => [ 'title', 'editor', 'thumbnail', 'excerpt', 'custom-fields' ], + 'rewrite' => [ 'slug' => 'case-studies' ], + ] ); +} ); +``` + +### Gutenberg Custom Block (block.json + PHP render) + +**block.json** defines the block schema and registers editor + render scripts. **render.php** handles server-side rendering without JavaScript dependency. + +### ACF Block Registration + +```php +add_action( 'acf/init', function () { + acf_register_block_type( [ + 'name' => 'testimonial', + 'title' => 'Testimonial', + 'render_callback' => 'my_theme_render_testimonial', + 'category' => 'my-theme', + 'supports' => [ 'align' => false, 'jsx' => true ], + ] ); +} ); +``` + +## Connections + +- [[CMSDeveloper]] uses WordPress as a primary CMS platform +- [[ContentModel-first]] applies to WordPress content modeling before theme code +- [[CodeOverConfiguration]] — WordPress settings belong in wp-config.php or code +- [[WooCommerce]] extends WordPress for e-commerce use cases +- [[HeadlessWP]] — WordPress as headless backend with Next.js/Nuxt front-end + +## Sources +- [[engineering-cms-developer]] diff --git a/wiki/index.md b/wiki/index.md index e6966078..b7e6da1e 100644 --- a/wiki/index.md +++ b/wiki/index.md @@ -4,6 +4,71 @@ - [Overview](overview.md) — living synthesis ## Sources +- [2026-05-01] [CMS Developer Agent Personality](sources/engineering-cms-developer.md) +- [2026-05-01] [Git Workflow Master Agent Personality](sources/engineering-git-workflow-master.md) +- [2026-05-01] [Senior Developer Agent Personality](sources/engineering-senior-developer.md) +- [2026-05-01] [Database Optimizer Agent Personality](sources/engineering-database-optimizer.md) +- [2026-05-01] [Threat Detection Engineer Agent Personality](sources/engineering-threat-detection-engineer.md) +- [2026-05-01] [AI Engineer Agent Personality](sources/engineering-ai-engineer.md) +- [2026-05-01] [Feishu Integration Developer Agent Personality](sources/engineering-feishu-integration-developer.md) +- [2026-05-01] [Email Intelligence Engineer Agent Personality](sources/engineering-email-intelligence-engineer.md) +- [2026-05-01] [Embedded Firmware Engineer Agent Personality](sources/engineering-embedded-firmware-engineer.md) +- [2026-05-01] [Rapid Prototyper Agent Personality](sources/engineering-rapid-prototyper.md) +- [2026-05-01] [WeChat Mini Program Developer Agent Personality](sources/engineering-wechat-mini-program-developer.md) +- [2026-05-01] [Technical Writer Agent Personality](sources/engineering-technical-writer.md) +- [2026-05-01] [Code Reviewer Agent Personality](sources/engineering-code-reviewer.md) +- [2026-05-01] [Backend Architect Agent Personality](sources/engineering-backend-architect.md) +- [2026-05-01] [Filament Optimization Specialist Agent Personality](sources/engineering-filament-optimization-specialist.md) +- [2026-05-01] [Autonomous Optimization Architect Agent Personality](sources/engineering-autonomous-optimization-architect.md) +- [2026-05-01] [Mobile App Builder Agent Personality](sources/engineering-mobile-app-builder.md) +- [2026-05-01] [Software Architect Agent Personality](sources/engineering-software-architect.md) +- [2026-05-01] [Godot Multiplayer Engineer Agent Personality](sources/godot-multiplayer-engineer.md) +- [2026-05-01] [Godot Shader Developer Agent Personality](sources/godot-shader-developer.md) +- [2026-05-01] [Godot Gameplay Scripter Agent Personality](sources/godot-gameplay-scripter.md) +- [2026-05-01] [Blender Add-on Engineer Agent Personality](sources/blender-addon-engineer.md) +- [2026-05-01] [Roblox Avatar Creator Agent Personality](sources/roblox-avatar-creator.md) +- [2026-05-01] [Roblox Systems Scripter Agent Personality](sources/roblox-systems-scripter.md) +- [2026-05-01] [Roblox Experience Designer](sources/roblox-experience-designer.md) +- [2026-05-01] [Unity Architect Agent Personality](sources/unity-architect.md) +- [2026-05-01] [Unity Multiplayer Engineer](sources/unity-multiplayer-engineer.md) +- [2026-05-01] [Unity Shader Graph Artist](sources/unity-shader-graph-artist.md) +- [2026-05-01] [Unity Editor Tool Developer](sources/unity-editor-tool-developer.md) +- [2026-05-01] [Unreal World Builder Agent Personality](sources/unreal-world-builder.md) +- [2026-04-30] [Unreal Systems Engineer](sources/unreal-systems-engineer.md) +- [2026-04-30] [Unreal Multiplayer Architect](sources/unreal-multiplayer-architect.md) +- [2026-04-30] [Unreal Technical Artist](sources/unreal-technical-artist.md) +- [2026-04-30] [Game Designer Agent Personality](sources/game-designer.md) +- [2026-04-30] [Narrative Designer Agent Personality](sources/narrative-designer.md) +- [2026-04-30] [Level Designer Agent Personality](sources/level-designer.md) +- [2026-04-30] [Technical Artist](sources/technical-artist.md) +- [2026-04-30] [Game Audio Engineer Agent](sources/game-audio-engineer.md) +- [2026-04-30] [AI Citation Strategist](sources/marketing-ai-citation-strategist.md) +- [2026-04-30] [Marketing Growth Hacker Agent](sources/marketing-growth-hacker.md) +- [2026-04-30] [Marketing Xiaohongshu Specialist](sources/marketing-xiaohongshu-specialist.md) +- [2026-04-30] [Marketing Podcast Strategist](sources/marketing-podcast-strategist.md) +- [2026-04-30] [Marketing Bilibili Content Strategist](sources/marketing-bilibili-content-strategist.md) +- [2026-04-30] [Content Creator](sources/marketing-content-creator.md) +- [2026-04-30] [Marketing Twitter Engager](sources/marketing-twitter-engager.md) +- [2026-04-30] [Marketing Livestream Commerce Coach](sources/marketing-livestream-commerce-coach.md) +- [2026-04-30] [Marketing TikTok Strategist](sources/marketing-tiktok-strategist.md) +- [2026-04-30] [Marketing SEO Specialist](sources/marketing-seo-specialist.md) +- [2026-04-30] [China Market Localization Strategist](sources/marketing-china-market-localization-strategist.md) +- [2026-04-30] [App Store Optimizer](sources/marketing-app-store-optimizer.md) +- [2026-04-30] [Marketing WeChat Official Account Manager](sources/marketing-wechat-official-account.md) +- [2026-04-30] [LinkedIn Content Creator](sources/marketing-linkedin-content-creator.md) +- [2026-04-30] [Marketing Weibo Strategist](sources/marketing-weibo-strategist.md) +- [2026-04-30] [Marketing Baidu SEO Specialist](sources/marketing-baidu-seo-specialist.md) +- [2026-04-30] [Marketing Carousel Growth Engine](sources/marketing-carousel-growth-engine.md) +- [2026-04-30] [Marketing Private Domain Operator](sources/marketing-private-domain-operator.md) +- [2026-04-30] [Marketing Short-Video Editing Coach](sources/marketing-short-video-editing-coach.md) +- [2026-04-30] [Social Media Strategist](sources/marketing-social-media-strategist.md) +- [2026-04-30] [Marketing Kuaishou Strategist](sources/marketing-kuaishou-strategist.md) +- [2026-04-30] [Marketing Video Optimization Specialist Agent](sources/marketing-video-optimization-specialist.md) +- [2026-04-30] [Marketing Instagram Curator](sources/marketing-instagram-curator.md) +- [2026-04-30] [Marketing China E-Commerce Operator](sources/marketing-china-ecommerce-operator.md) +- [2026-04-30] [Marketing Reddit Community Builder](sources/marketing-reddit-community-builder.md) +- [2026-04-30] [Marketing Cross-Border E-Commerce Specialist](sources/marketing-cross-border-ecommerce.md) +- [2026-04-30] [Book Co-Author](sources/marketing-book-co-author.md) - [2026-04-30] [Marketing Zhihu Strategist](sources/marketing-zhihu-strategist.md) - [2026-04-30] [Marketing Douyin Strategist](sources/marketing-douyin-strategist.md) - [2026-04-30] [Nexus Spatial: Full Agency Discovery Exercise](sources/nexus-spatial-discovery.md) @@ -402,11 +467,10 @@ - [2026-04-26] [Cloud Maturity Model - A Detailed Guide For Cloud Adoption](sources/cloud-maturity-model-a-detailed-guide-for-cloud-adoption.md) - [2026-04-26] [Cloud DevOp Maturity - Guideline](sources/cloud-devop-maturity-guideline.md) - [2026-04-26] [DevOps Culture and Transformation: Fostering Collaboration, Agile Practices, and Innovation](sources/devops-culture-and-transformation-fostering-collaboration-agile-practices-and-innovation-linkedin.md) +- [WSL2-中-Docker-容器访问宿主机代理](sources/WSL2-中-Docker-容器访问宿主机代理.md) — (expected: wiki/sources/WSL2-中-Docker-容器访问宿主机代理.md — source missing) - [Scrapy + Playwright 抓取TikTok Shop Data](sources/scrapy-playwright-抓取tiktok-shop-data.md) -- [engineering-technical-writer](sources/engineering-technical-writer.md) — (expected: wiki/sources/engineering-technical-writer.md — source missing) - [engineering-sre](sources/engineering-sre.md) — (expected: wiki/sources/engineering-sre.md — source missing) - [engineering-solidity-smart-contract-engineer](sources/engineering-solidity-smart-contract-engineer.md) — (expected: wiki/sources/engineering-solidity-smart-contract-engineer.md — source missing) -- [engineering-senior-developer](sources/engineering-senior-developer.md) — (expected: wiki/sources/engineering-senior-developer.md — source missing) - [Hermes-Agent-配置笔记](sources/Hermes-Agent-配置笔记.md) — (expected: wiki/sources/Hermes-Agent-配置笔记.md — source missing) - [baoyu-skills](sources/baoyu-skills.md) — (expected: wiki/sources/baoyu-skills.md — source missing) - [n8n-docker-配置-telegram-代理-troubleshooting](sources/n8n-docker-配置-telegram-代理-troubleshooting.md) — (expected: wiki/sources/n8n-docker-配置-telegram-代理-troubleshooting.md — source missing) @@ -443,83 +507,22 @@ - [healthcare-customer-service](sources/healthcare-customer-service.md) — (expected: wiki/sources/healthcare-customer-service.md — source missing) - [customer-service](sources/customer-service.md) — (expected: wiki/sources/customer-service.md — source missing) - [readme](sources/readme.md) — (expected: wiki/sources/readme.md — source missing) -- [Marketing Xiaohongshu Specialist](sources/marketing-xiaohongshu-specialist.md) -- [Marketing Weibo Strategist](sources/marketing-weibo-strategist.md) -- [Marketing WeChat Official Account Manager](sources/marketing-wechat-official-account.md) -- [Marketing Video Optimization Specialist](sources/marketing-video-optimization-specialist.md) -- [Marketing Twitter Engager](sources/marketing-twitter-engager.md) -- [Marketing TikTok Strategist](sources/marketing-tiktok-strategist.md) -- [Social Media Strategist](sources/marketing-social-media-strategist.md) -- [Marketing Short-Video Editing Coach](sources/marketing-short-video-editing-coach.md) -- [Marketing SEO Specialist](sources/marketing-seo-specialist.md) -- [Marketing Reddit Community Builder](sources/marketing-reddit-community-builder.md) -- [Marketing Private Domain Operator](sources/marketing-private-domain-operator.md) -- [Marketing Podcast Strategist](sources/marketing-podcast-strategist.md) -- [Marketing Livestream Commerce Coach](sources/marketing-livestream-commerce-coach.md) -- [LinkedIn Content Creator](sources/marketing-linkedin-content-creator.md) -- [Marketing Kuaishou Strategist](sources/marketing-kuaishou-strategist.md) -- [Marketing Instagram Curator](sources/marketing-instagram-curator.md) -- [Marketing Growth Hacker Agent](sources/marketing-growth-hacker.md) -- [Marketing Cross-Border E-Commerce Specialist](sources/marketing-cross-border-ecommerce.md) -- [Marketing Content Creator](sources/marketing-content-creator.md) -- [China Market Localization Strategist](sources/marketing-china-market-localization-strategist.md) -- [Marketing China E-Commerce Operator](sources/marketing-china-ecommerce-operator.md) -- [Marketing Carousel Growth Engine](sources/marketing-carousel-growth-engine.md) -- [Book Co-Author](sources/marketing-book-co-author.md) -- [Marketing Bilibili Content Strategist](sources/marketing-bilibili-content-strategist.md) -- [Marketing Baidu SEO Specialist](sources/marketing-baidu-seo-specialist.md) -- [App Store Optimizer](sources/marketing-app-store-optimizer.md) -- [AI Citation Strategist](sources/marketing-ai-citation-strategist.md) - [marketing-agentic-search-optimizer](sources/marketing-agentic-search-optimizer.md) — (expected: wiki/sources/marketing-agentic-search-optimizer.md — source missing) - [readme](sources/readme.md) — (expected: wiki/sources/readme.md — source missing) -- [Unreal World Builder Agent Personality](sources/unreal-world-builder.md) -- [Unreal Technical Artist](sources/unreal-technical-artist.md) -- [Unreal Systems Engineer](sources/unreal-systems-engineer.md) -- [Unreal Multiplayer Architect](sources/unreal-multiplayer-architect.md) -- [Unity Shader Graph Artist](sources/unity-shader-graph-artist.md) -- [Unity Multiplayer Engineer](sources/unity-multiplayer-engineer.md) -- [Unity Editor Tool Developer](sources/unity-editor-tool-developer.md) -- [Unity Architect](sources/unity-architect.md) -- [Technical Artist](sources/technical-artist.md) -- [Roblox Systems Scripter Agent Personality](sources/roblox-systems-scripter.md) -- [Roblox Experience Designer](sources/roblox-experience-designer.md) -- [Roblox Avatar Creator Agent Personality](sources/roblox-avatar-creator.md) -- [Narrative Designer Agent Personality](sources/narrative-designer.md) -- [Level Designer Agent Personality](sources/level-designer.md) -- [Godot Shader Developer Agent Personality](sources/godot-shader-developer.md) -- [Godot Multiplayer Engineer Agent Personality](sources/godot-multiplayer-engineer.md) -- [Godot Gameplay Scripter Agent Personality](sources/godot-gameplay-scripter.md) -- [Game Designer Agent Personality](sources/game-designer.md) -- [Game Audio Engineer Agent](sources/game-audio-engineer.md) -- [Blender Add-on Engineer Agent Personality](sources/blender-addon-engineer.md) - [finance-tax-strategist](sources/finance-tax-strategist.md) — (expected: wiki/sources/finance-tax-strategist.md — source missing) - [finance-investment-researcher](sources/finance-investment-researcher.md) — (expected: wiki/sources/finance-investment-researcher.md — source missing) - [finance-fpa-analyst](sources/finance-fpa-analyst.md) — (expected: wiki/sources/finance-fpa-analyst.md — source missing) - [finance-financial-analyst](sources/finance-financial-analyst.md) — (expected: wiki/sources/finance-financial-analyst.md — source missing) - [finance-bookkeeper-controller](sources/finance-bookkeeper-controller.md) — (expected: wiki/sources/finance-bookkeeper-controller.md — source missing) -- [engineering-wechat-mini-program-developer](sources/engineering-wechat-mini-program-developer.md) — (expected: wiki/sources/engineering-wechat-mini-program-developer.md — source missing) - [engineering-voice-ai-integration-engineer](sources/engineering-voice-ai-integration-engineer.md) — (expected: wiki/sources/engineering-voice-ai-integration-engineer.md — source missing) -- [engineering-threat-detection-engineer](sources/engineering-threat-detection-engineer.md) — (expected: wiki/sources/engineering-threat-detection-engineer.md — source missing) -- [Software Architect Agent Personality](sources/engineering-software-architect.md) - [engineering-security-engineer](sources/engineering-security-engineer.md) — (expected: wiki/sources/engineering-security-engineer.md — source missing) -- [engineering-rapid-prototyper](sources/engineering-rapid-prototyper.md) — (expected: wiki/sources/engineering-rapid-prototyper.md — source missing) -- [Mobile App Builder Agent Personality](sources/engineering-mobile-app-builder.md) - [engineering-minimal-change-engineer](sources/engineering-minimal-change-engineer.md) — (expected: wiki/sources/engineering-minimal-change-engineer.md — source missing) - [engineering-incident-response-commander](sources/engineering-incident-response-commander.md) — (expected: wiki/sources/engineering-incident-response-commander.md — source missing) -- [engineering-git-workflow-master](sources/engineering-git-workflow-master.md) — (expected: wiki/sources/engineering-git-workflow-master.md — source missing) - [engineering-frontend-developer](sources/engineering-frontend-developer.md) — (expected: wiki/sources/engineering-frontend-developer.md — source missing) -- [engineering-filament-optimization-specialist](sources/engineering-filament-optimization-specialist.md) — (expected: wiki/sources/engineering-filament-optimization-specialist.md — source missing) -- [engineering-feishu-integration-developer](sources/engineering-feishu-integration-developer.md) — (expected: wiki/sources/engineering-feishu-integration-developer.md — source missing) -- [engineering-embedded-firmware-engineer](sources/engineering-embedded-firmware-engineer.md) — (expected: wiki/sources/engineering-embedded-firmware-engineer.md — source missing) -- [engineering-email-intelligence-engineer](sources/engineering-email-intelligence-engineer.md) — (expected: wiki/sources/engineering-email-intelligence-engineer.md — source missing) - [engineering-devops-automator](sources/engineering-devops-automator.md) — (expected: wiki/sources/engineering-devops-automator.md — source missing) -- [engineering-database-optimizer](sources/engineering-database-optimizer.md) — (expected: wiki/sources/engineering-database-optimizer.md — source missing) - [engineering-data-engineer](sources/engineering-data-engineer.md) — (expected: wiki/sources/engineering-data-engineer.md — source missing) - [engineering-codebase-onboarding-engineer](sources/engineering-codebase-onboarding-engineer.md) — (expected: wiki/sources/engineering-codebase-onboarding-engineer.md — source missing) -- [engineering-code-reviewer](sources/engineering-code-reviewer.md) — (expected: wiki/sources/engineering-code-reviewer.md — source missing) - [engineering-cms-developer](sources/engineering-cms-developer.md) — (expected: wiki/sources/engineering-cms-developer.md — source missing) -- [Autonomous Optimization Architect](sources/engineering-autonomous-optimization-architect.md) -- [engineering-ai-engineer](sources/engineering-ai-engineer.md) — (expected: wiki/sources/engineering-ai-engineer.md — source missing) - [engineering-ai-data-remediation-engineer](sources/engineering-ai-data-remediation-engineer.md) — (expected: wiki/sources/engineering-ai-data-remediation-engineer.md — source missing) - [security](sources/security.md) — (expected: wiki/sources/security.md — source missing) - [Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog](sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md) — (expected: wiki/sources/Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog.md — source missing) @@ -528,9 +531,10 @@ - [karpathy-最新分享-用-llm-搭建个人知识库-告别-rag-的低效循环](sources/karpathy-最新分享-用-llm-搭建个人知识库-告别-rag-的低效循环.md) — (expected: wiki/sources/karpathy-最新分享-用-llm-搭建个人知识库-告别-rag-的低效循环.md — source missing) - [Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend](sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md) — (expected: wiki/sources/Expose-hermes-agent-as-an-OpenAI-compatible-API-for-any-frontend.md — source missing) - [如何让ai生成风格一致的图片](sources/如何让ai生成风格一致的图片.md) — (expected: wiki/sources/如何让ai生成风格一致的图片.md — source missing) -- [engineering-backend-architect](sources/engineering-backend-architect.md) — (expected: wiki/sources/engineering-backend-architect.md — source missing) ## Entities +- [WordPress](entities/WordPress.md) — 开源 CMS 平台，适合编辑简单性/WooCommerce/广泛插件生态 +- [Drupal](entities/Drupal.md) — 企业级开源 CMS，擅长复杂内容模型/多语言/高可扩展性场景 - [1point3acres](entities/1point3acres.md) - [@witcheer](entities/@witcheer.md) - [Acemoglu](entities/Acemoglu.md) @@ -608,6 +612,7 @@ - [baoyu](entities/baoyu.md) - [BCS](entities/BCS.md) - [BehavioralNudgeEngine](entities/BehavioralNudgeEngine.md) +- [Bilibili](entities/Bilibili.md) - [bitwarden](entities/bitwarden.md) - [blackbox-exporter](entities/blackbox-exporter.md) - [BlackboxExporter](entities/BlackboxExporter.md) @@ -705,10 +710,12 @@ - [ECS-Deploy-Runner](entities/ECS-Deploy-Runner.md) - [Ed](entities/Ed.md) - [EESJGong](entities/EESJGong.md) +- [EpicGames](entities/EpicGames.md) - [Ethan-Mollick](entities/Ethan-Mollick.md) - [Euler-Finance](entities/Euler-Finance.md) - [Eurocode](entities/Eurocode.md) - [EvidenceQA](entities/EvidenceQA.md) +- [FBA](entities/FBA.md) - [Fibos](entities/Fibos.md) - [Filos-Christolakis](entities/Filos-Christolakis.md) - [Final-Cut-Pro](entities/Final-Cut-Pro.md) @@ -889,6 +896,7 @@ - [Playwright](entities/Playwright.md) - [Podcastfy](entities/Podcastfy.md) - [Portainer](entities/Portainer.md) +- [PostgreSQL](entities/PostgreSQL.md) - [Pradeep](entities/Pradeep.md) - [Prismer](entities/Prismer.md) - [Prismer-AI](entities/Prismer-AI.md) @@ -937,6 +945,7 @@ - [Shared-Account](entities/Shared-Account.md) - [shenwei](entities/shenwei.md) - [Shikad-Holtzman](entities/Shikad-Holtzman.md) +- [Shopify](entities/Shopify.md) - [SilverPeak](entities/SilverPeak.md) - [Simon-Hoiberg](entities/Simon-Hoiberg.md) - [Slack](entities/Slack.md) @@ -996,6 +1005,7 @@ - [UCMDB](entities/UCMDB.md) - [Uday](entities/Uday.md) - [UI-Designer](entities/UI-Designer.md) +- [Unity](entities/Unity.md) - [UnityGamingServices](entities/UnityGamingServices.md) - [UnityMultiplayerEngineer](entities/UnityMultiplayerEngineer.md) - [UnrealEngine5](entities/UnrealEngine5.md) @@ -1063,6 +1073,8 @@ - [도장](entities/도장.md) ## Concepts +- [ContentModel-first](concepts/ContentModel-first.md) — CMS 开发原则：先锁定字段/内容类型/编辑工作流，再编写主题代码 +- [CodeOverConfiguration](concepts/CodeOverConfiguration.md) — CMS 开发原则：所有结构变更通过代码注册，不依赖后台 UI - [14种UML图](concepts/14种UML图.md) - [2D-First-Spatial-Second](concepts/2D-First-Spatial-Second.md) - [3-2-1产品介绍公式](concepts/3-2-1产品介绍公式.md) @@ -1076,11 +1088,13 @@ - [Account-Monitoring](concepts/Account-Monitoring.md) - [Account-Tiering-Model](concepts/Account-Tiering-Model.md) - [AccountArchitecture](concepts/AccountArchitecture.md) +- [ACOS](concepts/ACOS.md) - [ActionItemTracking](concepts/ActionItemTracking.md) - [Active-Accountability](concepts/Active-Accountability.md) - [Active-Directory-Integration](concepts/Active-Directory-Integration.md) - [ActiveAccountability](concepts/ActiveAccountability.md) - [Actor-Replication](concepts/Actor-Replication.md) +- [ActorReplication](concepts/ActorReplication.md) - [Adaptive-Tone](concepts/Adaptive-Tone.md) - [AdaptiveMusic](concepts/AdaptiveMusic.md) - [AdaptiveTone](concepts/AdaptiveTone.md) @@ -1147,6 +1161,7 @@ - [APT-仓库配置](concepts/APT-仓库配置.md) - [Architectural-Empathy](concepts/Architectural-Empathy.md) - [Architecture-Roadmap](concepts/Architecture-Roadmap.md) +- [ArchitectureDecisionRecord](concepts/ArchitectureDecisionRecord.md) - [ARM-AMI](concepts/ARM-AMI.md) - [Artifact-Repo](concepts/Artifact-Repo.md) - [arXiv-API](concepts/arXiv-API.md) @@ -1248,6 +1263,8 @@ - [Change-Failure-Rate](concepts/Change-Failure-Rate.md) - [Change-Management](concepts/Change-Management.md) - [Channel-Based-Monitoring](concepts/Channel-Based-Monitoring.md) +- [Chaos-Physics](concepts/Chaos-Physics.md) +- [ChapterBlueprint](concepts/ChapterBlueprint.md) - [Character-Arc](concepts/Character-Arc.md) - [Character-Voice-Pillars](concepts/Character-Voice-Pillars.md) - [CharacterArc](concepts/CharacterArc.md) @@ -1261,6 +1278,7 @@ - [CI-CD-Secrets](concepts/CI-CD-Secrets.md) - [CICDPipeline](concepts/CICDPipeline.md) - [CIDR-审批流程](concepts/CIDR-审批流程.md) +- [Circuit-Breaker](concepts/Circuit-Breaker.md) - [CircuitBreaker](concepts/CircuitBreaker.md) - [CIS-Benchmark](concepts/CIS-Benchmark.md) - [Citation-Rate](concepts/Citation-Rate.md) @@ -1308,6 +1326,7 @@ - [Compliance-Risk-Matrix](concepts/Compliance-Risk-Matrix.md) - [Confidence-Score](concepts/Confidence-Score.md) - [Configuration-Management](concepts/Configuration-Management.md) +- [ConnectionPooling](concepts/ConnectionPooling.md) - [Consensus-Voting-Pattern](concepts/Consensus-Voting-Pattern.md) - [Constraint-Driven-Control-Mechanics](concepts/Constraint-Driven-Control-Mechanics.md) - [Container-Image-Tagging](concepts/Container-Image-Tagging.md) @@ -1402,6 +1421,7 @@ - [Disaster-Recovery](concepts/Disaster-Recovery.md) - [Discrimination-Metrics](concepts/Discrimination-Metrics.md) - [Distribution-Key](concepts/Distribution-Key.md) +- [Divio-Documentation-System](concepts/Divio-Documentation-System.md) - [DKIM-Email-Authentication](concepts/DKIM-Email-Authentication.md) - [dm-verity](concepts/dm-verity.md) - [DNS-Anycast](concepts/DNS-Anycast.md) @@ -1414,9 +1434,11 @@ - [Docker堆栈](concepts/Docker堆栈.md) - [Docker容器生命周期管理](concepts/Docker容器生命周期管理.md) - [Docker警告处理](concepts/Docker警告处理.md) +- [Docs-as-Code](concepts/Docs-as-Code.md) - [DocumentationTheater](concepts/DocumentationTheater.md) - [Domain-Join](concepts/Domain-Join.md) - [Domain-Thinking](concepts/Domain-Thinking.md) +- [DomainDrivenDesign](concepts/DomainDrivenDesign.md) - [DORA-Metrics](concepts/DORA-Metrics.md) - [DRaaS](concepts/DRaaS.md) - [Dream-Cycle](concepts/Dream-Cycle.md) @@ -1436,6 +1458,7 @@ - [ECS](concepts/ECS.md) - [ECS-Deploy-Runner](concepts/ECS-Deploy-Runner.md) - [ECS-Module](concepts/ECS-Module.md) +- [EditorialWorkflow](concepts/EditorialWorkflow.md) - [efibootmgr](concepts/efibootmgr.md) - [EFS-vs-EBS](concepts/EFS-vs-EBS.md) - [EKS-Auto-Mode](concepts/EKS-Auto-Mode.md) @@ -1487,6 +1510,7 @@ - [File-Watcher](concepts/File-Watcher.md) - [Fine-Tuning](concepts/Fine-Tuning.md) - [FinOps](concepts/FinOps.md) +- [FirstPersonBusinessWriting](concepts/FirstPersonBusinessWriting.md) - [Five-Layer-Prompt-Structure](concepts/Five-Layer-Prompt-Structure.md) - [Five-Phase-Script-Framework](concepts/Five-Phase-Script-Framework.md) - [Fix-Pack](concepts/Fix-Pack.md) @@ -1509,6 +1533,7 @@ - [Gamification](concepts/Gamification.md) - [Gamification-System](concepts/Gamification-System.md) - [GapAssessment](concepts/GapAssessment.md) +- [GAS](concepts/GAS.md) - [GAS-Gameplay-Ability-System](concepts/GAS-Gameplay-Ability-System.md) - [Gate-Process](concepts/Gate-Process.md) - [Gatekeeper](concepts/Gatekeeper.md) @@ -1523,6 +1548,7 @@ - [Genetic-Algorithm](concepts/Genetic-Algorithm.md) - [Genre-Specific-Prompt-Patterns](concepts/Genre-Specific-Prompt-Patterns.md) - [Geographic-Coherence](concepts/Geographic-Coherence.md) +- [Ghostwriting](concepts/Ghostwriting.md) - [Gift-Economy](concepts/Gift-Economy.md) - [GitAsAuditLog](concepts/GitAsAuditLog.md) - [GitHub-Release-Monitoring](concepts/GitHub-Release-Monitoring.md) @@ -1540,19 +1566,23 @@ - [Grandes-Ecoles](concepts/Grandes-Ecoles.md) - [Graviton](concepts/Graviton.md) - [Green-Computing](concepts/Green-Computing.md) +- [Grey-Box-Blockout](concepts/Grey-Box-Blockout.md) - [Groupthink](concepts/Groupthink.md) - [Growth-Loop](concepts/Growth-Loop.md) - [GrowthFunnelOptimization](concepts/GrowthFunnelOptimization.md) +- [GTM-Phase-Gate](concepts/GTM-Phase-Gate.md) - [Habit-Formation](concepts/Habit-Formation.md) - [Hallucination](concepts/Hallucination.md) - [Hand-Tracking](concepts/Hand-Tracking.md) - [Handoff-Contract](concepts/Handoff-Contract.md) - [HCX](concepts/HCX.md) +- [HDRP](concepts/HDRP.md) - [Headless-服务器](concepts/Headless-服务器.md) - [Healthcare-Marketing-Compliance](concepts/Healthcare-Marketing-Compliance.md) - [Heartbeat-Monitoring](concepts/Heartbeat-Monitoring.md) - [HeroesJourney](concepts/HeroesJourney.md) - [Hidden-Failure-Paths](concepts/Hidden-Failure-Paths.md) +- [HierarchicalLOD](concepts/HierarchicalLOD.md) - [Hierarchy-Agent-Pattern](concepts/Hierarchy-Agent-Pattern.md) - [high-availability](concepts/high-availability.md) - [Historiography](concepts/Historiography.md) @@ -1597,6 +1627,7 @@ - [Incrementality-Testing](concepts/Incrementality-Testing.md) - [IncrementalityTesting](concepts/IncrementalityTesting.md) - [Indexing](concepts/Indexing.md) +- [IndexingStrategies](concepts/IndexingStrategies.md) - [Infoblox-Grid](concepts/Infoblox-Grid.md) - [Infoblox-NIOS](concepts/Infoblox-NIOS.md) - [Infrastructure-as-Code](concepts/Infrastructure-as-Code.md) @@ -1650,6 +1681,7 @@ - [LagCompensation](concepts/LagCompensation.md) - [Land-and-Expand](concepts/Land-and-Expand.md) - [Landing-Zone-Architecture](concepts/Landing-Zone-Architecture.md) +- [Landscape](concepts/Landscape.md) - [LangChain](concepts/LangChain.md) - [Language-Detection](concepts/Language-Detection.md) - [LanguageServerProtocol](concepts/LanguageServerProtocol.md) @@ -1669,11 +1701,13 @@ - [Liminality](concepts/Liminality.md) - [Link-Proposer](concepts/Link-Proposer.md) - [Liquid-Glass-Design-System](concepts/Liquid-Glass-Design-System.md) +- [LLM-as-a-Judge](concepts/LLM-as-a-Judge.md) - [LLM-Wiki](concepts/LLM-Wiki.md) - [LLMasJudge](concepts/LLMasJudge.md) - [Local-Caching](concepts/Local-Caching.md) - [Local-first-Git](concepts/Local-first-Git.md) - [Local-LLM-Deployment](concepts/Local-LLM-Deployment.md) +- [Localization](concepts/Localization.md) - [Lockable-Workflow](concepts/Lockable-Workflow.md) - [LOD](concepts/LOD.md) - [LOD-Pipeline](concepts/LOD-Pipeline.md) @@ -1689,6 +1723,7 @@ - [Management-Pack](concepts/Management-Pack.md) - [MarkdownBasedTask](concepts/MarkdownBasedTask.md) - [Marketing-Attribution](concepts/Marketing-Attribution.md) +- [Mass-Entity](concepts/Mass-Entity.md) - [Material-Culture](concepts/Material-Culture.md) - [MaterialFunction](concepts/MaterialFunction.md) - [MCPOnceAllAgents](concepts/MCPOnceAllAgents.md) @@ -1738,6 +1773,7 @@ - [Multi-Window-Architecture](concepts/Multi-Window-Architecture.md) - [MVP](concepts/MVP.md) - [Mythril](concepts/Mythril.md) +- [N1QueryPrevention](concepts/N1QueryPrevention.md) - [n8n-Workflow-Standard](concepts/n8n-Workflow-Standard.md) - [N8NNodeTypes](concepts/N8NNodeTypes.md) - [N8nWorkflowStandard](concepts/N8nWorkflowStandard.md) @@ -1745,6 +1781,7 @@ - [Narrative-Debt](concepts/Narrative-Debt.md) - [Narrative-Debt-Tracking](concepts/Narrative-Debt-Tracking.md) - [Narrative-Gameplay-Integration](concepts/Narrative-Gameplay-Integration.md) +- [NarrativeArchitecture](concepts/NarrativeArchitecture.md) - [NarrativeTheory](concepts/NarrativeTheory.md) - [nas套件管理](concepts/nas套件管理.md) - [National-Annex](concepts/National-Annex.md) @@ -1752,8 +1789,10 @@ - [Negative-Prompting](concepts/Negative-Prompting.md) - [NegativePromptingLibrary](concepts/NegativePromptingLibrary.md) - [Net-Revenue-Retention](concepts/Net-Revenue-Retention.md) +- [NetUpdateFrequency](concepts/NetUpdateFrequency.md) - [Network-Prediction](concepts/Network-Prediction.md) - [Network-Segmentation](concepts/Network-Segmentation.md) +- [NetworkPrediction](concepts/NetworkPrediction.md) - [NetworkVariable](concepts/NetworkVariable.md) - [NFS网络备份](concepts/NFS网络备份.md) - [NiagaraVFX](concepts/NiagaraVFX.md) @@ -1773,6 +1812,7 @@ - [Obsidian-Tasks](concepts/Obsidian-Tasks.md) - [ObsidianRecurringTasks](concepts/ObsidianRecurringTasks.md) - [Oli-Workflow](concepts/Oli-Workflow.md) +- [OneFilePerActor](concepts/OneFilePerActor.md) - [OpenClaw-Deployment-Expert](concepts/OpenClaw-Deployment-Expert.md) - [OpenTelemetry](concepts/OpenTelemetry.md) - [OpenText-Tagging-Standard](concepts/OpenText-Tagging-Standard.md) @@ -1787,6 +1827,7 @@ - [Override-Status](concepts/Override-Status.md) - [OWASP-Top-Ten](concepts/OWASP-Top-Ten.md) - [Pacing-Architecture](concepts/Pacing-Architecture.md) +- [Pacing-Chart](concepts/Pacing-Chart.md) - [PagedAttention](concepts/PagedAttention.md) - [Pain-Point-Mining](concepts/Pain-Point-Mining.md) - [Paper-Abstract-Batch-Fetching](concepts/Paper-Abstract-Batch-Fetching.md) @@ -1849,6 +1890,7 @@ - [ProactiveAI](concepts/ProactiveAI.md) - [Problem-Management](concepts/Problem-Management.md) - [Procedural-Level-Design](concepts/Procedural-Level-Design.md) +- [ProceduralContentGeneration](concepts/ProceduralContentGeneration.md) - [process-management](concepts/process-management.md) - [Product-Backlog](concepts/Product-Backlog.md) - [Product-Hierarchy](concepts/Product-Hierarchy.md) @@ -1885,6 +1927,7 @@ - [QualityGate](concepts/QualityGate.md) - [QualitySwitch](concepts/QualitySwitch.md) - [QueryLanguage](concepts/QueryLanguage.md) +- [QueryPlanAnalysis](concepts/QueryPlanAnalysis.md) - [Quick-Capture](concepts/Quick-Capture.md) - [RACI](concepts/RACI.md) - [RAG](concepts/RAG.md) @@ -1915,6 +1958,7 @@ - [RemoteRescuePattern](concepts/RemoteRescuePattern.md) - [Renovate-Bot](concepts/Renovate-Bot.md) - [Replication-Graph](concepts/Replication-Graph.md) +- [ReplicationGraph](concepts/ReplicationGraph.md) - [Repo-Mirroring](concepts/Repo-Mirroring.md) - [Requirements-Gathering](concepts/Requirements-Gathering.md) - [Research-Triangulation](concepts/Research-Triangulation.md) @@ -1937,6 +1981,7 @@ - [Root-Cause-Analysis](concepts/Root-Cause-Analysis.md) - [Root-Terragrunt-HCL](concepts/Root-Terragrunt-HCL.md) - [Route-53-Resolver](concepts/Route-53-Resolver.md) +- [RPC](concepts/RPC.md) - [RPC-Remote-Procedure-Call](concepts/RPC-Remote-Procedure-Call.md) - [RPO](concepts/RPO.md) - [RRF-Reranking](concepts/RRF-Reranking.md) @@ -1982,6 +2027,7 @@ - [Self-Sufficiency](concepts/Self-Sufficiency.md) - [Semantic-Deduplication](concepts/Semantic-Deduplication.md) - [Semantic-Index-Infrastructure](concepts/Semantic-Index-Infrastructure.md) +- [Semantic-Routing](concepts/Semantic-Routing.md) - [Semantic-Search](concepts/Semantic-Search.md) - [Semantic-Versioning](concepts/Semantic-Versioning.md) - [Semantic-Zoom](concepts/Semantic-Zoom.md) @@ -1991,6 +2037,7 @@ - [Sequential-Thinking](concepts/Sequential-Thinking.md) - [SequentialThinking](concepts/SequentialThinking.md) - [Server-Authoritative-Model](concepts/Server-Authoritative-Model.md) +- [Server-AuthoritativeModel](concepts/Server-AuthoritativeModel.md) - [ServerAuthority](concepts/ServerAuthority.md) - [Serverless-Computing](concepts/Serverless-Computing.md) - [Service-Control-Policies-SCPs](concepts/Service-Control-Policies-SCPs.md) @@ -1998,6 +2045,7 @@ - [serviceable-obtainable-market](concepts/serviceable-obtainable-market.md) - [SES-Sandbox-Mode](concepts/SES-Sandbox-Mode.md) - [Shader](concepts/Shader.md) +- [Shadow-Traffic](concepts/Shadow-Traffic.md) - [ShadowTraffic](concepts/ShadowTraffic.md) - [SHAP](concepts/SHAP.md) - [Shared-Account](concepts/Shared-Account.md) @@ -2113,6 +2161,7 @@ - [Theme-Toggle](concepts/Theme-Toggle.md) - [Third Party Penetration Testing](concepts/Third Party Penetration Testing.md) - [Thought-Leadership](concepts/Thought-Leadership.md) +- [ThoughtLeadershipBook](concepts/ThoughtLeadershipBook.md) - [Threat-Intelligence](concepts/Threat-Intelligence.md) - [Threat-Modeling](concepts/Threat-Modeling.md) - [Three-Act-Proposal-Narrative](concepts/Three-Act-Proposal-Narrative.md) @@ -2158,6 +2207,7 @@ - [UnityLobby](concepts/UnityLobby.md) - [UnityRelay](concepts/UnityRelay.md) - [Urban-Sprawl](concepts/Urban-Sprawl.md) +- [URP](concepts/URP.md) - [Usability-Testing](concepts/Usability-Testing.md) - [User-Journey-Mapping](concepts/User-Journey-Mapping.md) - [User-Persona](concepts/User-Persona.md) @@ -2183,6 +2233,7 @@ - [VMware-Cloud-on-AWS](concepts/VMware-Cloud-on-AWS.md) - [Voice-Interface](concepts/Voice-Interface.md) - [Voice-Notification-Channel](concepts/Voice-Notification-Channel.md) +- [VoiceProtection](concepts/VoiceProtection.md) - [VPC-Association-Authorization](concepts/VPC-Association-Authorization.md) - [VPC-Endpoint](concepts/VPC-Endpoint.md) - [VPC-自动化供给](concepts/VPC-自动化供给.md) @@ -2316,12 +2367,5 @@ - [首尾针动画](concepts/首尾针动画.md) - [품의](concepts/품의.md) - [회식](concepts/회식.md) -- [Chapter Blueprint](concepts/ChapterBlueprint.md) — 章节起草前的结构化规划工具：章节承诺 + 五段式逻辑结构 -- [Editorial Workflow](concepts/EditorialWorkflow.md) — 版本化草稿 + 显式编辑注释 + 明确反馈回路的迭代修订流程 -- [First-Person Business Writing](concepts/FirstPersonBusinessWriting.md) — 以作者亲身经历为叙事主轴的商业写作形式 -- [Ghostwriting](concepts/Ghostwriting.md) — 代笔写作：保留委托方声音，由代笔人完成实际写作的内容生产模式 -- [Narrative Architecture](concepts/NarrativeArchitecture.md) — 维护全书跨章节"红色主线"的叙事架构设计原则 -- [Thought Leadership Book](concepts/ThoughtLeadershipBook.md) — 以第一人称视角建立品类权威的思想领导力书籍 -- [Voice Protection](concepts/VoiceProtection.md) — AI 辅助写作中保留委托方个人声音个性的原则与技术 ## Syntheses diff --git a/wiki/log.md b/wiki/log.md index 4fddea1c..a8d5ec6f 100644 --- a/wiki/log.md +++ b/wiki/log.md @@ -1,4 +1,377 @@ -## [2026-05-13] ingest | Marketing Douyin Strategist +## [2026-05-01] ingest | Git Workflow Master Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-git-workflow-master.md +- Status: ✅ 成功摄入 +- Summary: Git Workflow Master Agent 个性定义——Git 工作流与版本控制策略专家 Agent，帮助团队维护干净提交历史、有效分支策略，掌握高级 Git 特性（worktree/interactive rebase/bisect）。核心理念："Clean history, atomic commits, and branches that tell a story." 核心使命：原子提交、Smart branching、Safe collaboration、Advanced techniques（worktrees/bisect/reflog/cherry-pick）、CI integration。关键规则：永远不要在共享分支上强制推送（用 `--force-with-lease`）、PR 前必须 rebase 到目标分支最新代码。分支策略：Trunk-Based（主推，大多数团队）和 Git Flow（版本发布团队）。 +- Concepts created: 无需创建（AtomicCommits/ConventionalCommits/TrunkBasedDevelopment/GitFlow/ForceWithLease 等概念仅在本页首次提及，未在其他页面引用，无需独立 Concept 页） +- Entities created: 无需创建（本文档为 Agent 个性定义，无外部公司/产品引用） +- Source page: wiki/sources/engineering-git-workflow-master.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-git-workflow-master.md）；index.md已更新（Sources节新增条目，日期2026-05-01排第一）；overview.md Engineering Agents部分新增entry；冲突检测：与 GitFlow 策略存在视角差异（Trunk-Based 主推 vs GitFlow 适合版本发布），属互补关系而非直接矛盾；wikilinks（AtomicCommits/ConventionalCommits/TrunkBasedDevelopment/GitFlow/ForceWithLease/CodeReviewer/GitOps）指向的页面暂不存在，待后续摄取相关来源时一并建立；log.md已追加。 + +## [2026-05-01] ingest | Senior Developer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-senior-developer.md +- Status: ✅ 成功摄入 +- Summary: Senior Developer Agent 个性定义——专注于使用 Laravel/Livewire/FluxUI 实现"奢华感"（Premium）web 体验的高级全栈开发者 Agent。核心理念："Every pixel should feel intentional and refined"，性能与美感必须共存。技术栈：Laravel/Livewire 全栈框架、FluxUI 专业组件库、高级 CSS（glass morphism、organic shapes、cubic-bezier 缓动曲线）、Three.js WebGL 集成。核心要求：必须实现亮色/暗色/系统主题切换、玻璃拟态视觉效果、磁性按钮微交互。质量标准：加载 < 1.5s、动画 60fps、WCAG 2.1 AA 无障碍。 +- Concepts created: 无需创建（Glass Morphism/Three.js Integration/Premium Design Standards 等概念仅在本页首次提及1次，无独立 Concept 页必要） +- Entities created: 无需创建（Laravel/Livewire/FluxUI/Three.js 等技术栈在各 Engineering Agent 中已有引用基础，本页仅列举实现工具） +- Source page: wiki/sources/engineering-senior-developer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-senior-developer.md）；index.md已更新（Sources节新增条目，日期2026-05-01排第一）；overview.md第9行 Engineering Agents 部分新增 entry；冲突检测：无已知冲突；与 xr-immersive-developer 中 Three.js 描述一致（均用于 WebGL 沉浸式体验）；log.md已追加。 + +## [2026-05-01] ingest | Database Optimizer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-database-optimizer.md +- Status: ✅ 成功摄入 +- Summary: Database Optimizer Agent 个性定义——专注于数据库性能优化的专家 Agent，主要支持 PostgreSQL、MySQL、Supabase 和 PlanetScale。核心专长：EXPLAIN ANALYZE 查询计划分析、B-tree/GiST/GIN/部分索引/复合索引策略、N+1 查询检测与解决（JOIN + json_agg）、连接池管理（PgBouncer/Supabase pooler）、零停机迁移（CONCURRENTLY）。核心规则：始终检查查询计划、外键必须加索引、避免 SELECT *、使用连接池、迁移必须可逆、生产环境永不锁表。提供可直接用于生产的 SQL 模板和 TypeScript 代码示例。 +- Concepts created: IndexingStrategies / N1QueryPrevention / QueryPlanAnalysis / ConnectionPooling — 均仅本次首次提及，均已创建独立 Concept 页面 +- Entities created: PostgreSQL — 仅本次首次提及，已创建独立 Entity 页面 +- Source page: wiki/sources/engineering-database-optimizer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-database-optimizer.md）；index.md已更新（Sources节新增条目；Concepts节新增IndexingStrategies、N1QueryPrevention、QueryPlanAnalysis、ConnectionPooling；Entities节新增PostgreSQL）；overview.md Engineering Agents部分新增entry；冲突检测：无已知冲突；log.md已追加。 + +## [2026-05-01] ingest | AI Engineer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-ai-engineer.md +- Status: ✅ 成功摄入 +- Summary: AI/ML 工程师 Agent 个性定义——专注于机器学习模型开发、部署与生产系统集成的完整生命周期。核心定位："Turns ML models into production features that actually scale." 核心能力矩阵：ML 框架（TensorFlow/PyTorch/HuggingFace）、LLM 集成（RAG/Fine-tuning）、向量数据库（Pinecone/Weaviate/Chroma/FAISS）、MLOps（MLflow/Kubeflow）、生产集成模式（实时 API <100ms/批处理/流式/边缘推理）。AI 安全底线：偏见检测、公平性指标、差分隐私、对抗鲁棒性。核心成功指标：推理延迟 <100ms、模型可用性 >99.5%、漂移检测自动触发再训练。 +- Concepts created: MLOps / RAG / PromptEngineering / FairnessInML / ModelDriftDetection / DistributedTraining / ExplainableAI / DifferentialPrivacy — RAG 和 MLOps 已在 Wiki 中存在（LangChain/Open-WebUI/Amazon-SageMaker 等页面已引用），其余概念均仅在本页提及1次，无需独立 Concept 页 +- Entities created: OpenAI / Anthropic / HuggingFace / TensorFlow / PyTorch / FastAPI / MLflow / Kubeflow / Pinecone / FAISS — 大多数已在 Wiki 中存在（Anthropic/Azure/Google-Cloud/Andrej-Karpathy 等页面已引用），其余仅提及1次，无需独立 Entity 页 +- Source page: wiki/sources/engineering-ai-engineer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-ai-engineer.md）；index.md已更新（Sources 节新增条目，日期2026-05-01排第一）；overview.md第86行 Engineering Agents 部分新增 entry；冲突检测：无已知冲突；log.md已追加。 + +## [2026-05-01] ingest | Rapid Prototyper Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-rapid-prototyper.md +- Status: ✅ 成功摄入 +- Summary: Rapid Prototyper Agent 个性定义——极速原型开发专家，专注 3 天内交付可工作 MVP。速度优先开发：选择最小化设置时间的工具，先核心功能再边界情况，优先用户面功能。验证驱动开发：只构建核心假设测试所需功能，从第一天内置用户反馈和数据分析。技术栈：Next.js 14 + Supabase + Prisma + Clerk + shadcn/ui + Vercel。成功指标：3 天原型交付、1 周用户反馈、80% 核心功能通过验证、2 周内原型到生产转化。 +- Concepts created: MVP / A/B Testing / Rapid Prototyping / 用户反馈收集 / No-Code/Low-Code — 均仅在本页提及 1 次，不满足 ≥2 次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Next.js / Supabase / Clerk / Prisma / shadcn/ui / Vercel — 均仅提及 1 次，不满足 ≥2 次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-rapid-prototyper.md +- Notes: 与 SoftwareArchitect 和 BackendArchitect 互补，无冲突 + +## [2026-05-01] ingest | WeChat Mini Program Developer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-wechat-mini-program-developer.md +- Status: ✅ 成功摄入 +- Summary: WeChat Mini Program Developer Agent 人格定义——专注于微信生态高性能小程序全栈开发的 AI Agent。核心约束：双线程架构（无 DOM/需 setData）、包体积限制（主包 ≤2MB/子包 ≤20MB）、域名白名单 + HTTPS 强制。核心交付物：项目结构规范、request.js 统一请求封装、微信支付集成模板、性能优化页面模板。跨平台：Taro/uni-app。成功指标：启动 <1.5s、主包 <1.5MB、审核首次通过率 >90%。 +- Concepts created: 微信小程序 / setData优化 / 子包加载 / WXML/WXSS / 微信支付集成 / 跨平台小程序框架 — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: 微信 / Taro / uni-app — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-wechat-mini-program-developer.md +- Notes: 步骤1-9全部完成；source page已生成；index.md已更新（Sources 节新增条目）；overview.md第1181行后新增 entry 30；冲突检测：无已知冲突；log.md已追加。 + + +## [2026-05-01] ingest | Technical Writer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-technical-writer.md +- Status: ✅ 成功摄入 +- Summary: Technical Writer Agent 人格定义——技术文档工程师，专注于将复杂工程概念转化为开发者真正愿意阅读的清晰、准确、引人入胜的文档。核心理念："Bad documentation is a product bug." 核心方法：Divio 文档体系（教程/操作指南/参考文档/解释文档四象限分离）；Docs-as-Code 基础设施（Docusaurus/MkDocs/Sphinx/VitePress + CI/CD）；OpenAPI/Swagger 自动生成 API 参考文档；质量门禁（零错误代码示例、无文档的代码视为不完整）。核心指标：支持工单降低 20%、新开发者 15 分钟内上手、文档搜索满意度 ≥ 80%。属 The Agency Engineering 部门。 +- Concepts created: [[Divio-Documentation-System]] / [[Docs-as-Code]] — 两个概念均为可抽象、可复用的方法论框架，满足创建条件；其余概念（OpenAPI/Swagger、Vale、Redoc、Stoplight 等工具）仅在本页提及1次，无需独立页面 +- Entities: [[Docusaurus]] / [[MkDocs]] / [[Sphinx]] / [[VitePress]] / [[OpenAPI]] / [[Vale]] / [[Redoc]] / [[Stoplight]] — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页；已作为 Key Entities 在 Source Page 中引用 +- Source page: wiki/sources/engineering-technical-writer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-technical-writer.md）；index.md已更新（Sources 节第460行，从 missing 状态替换为正式条目）；overview.md第79行后新增条目；创建了两个 Concept 页面（Divio-Documentation-System 和 Docs-as-Code）；index.md Concepts 节新增两个条目（第1412-1413行）；冲突检测：与 specialized-developer-advocate 的内容边界冲突已在双方 Source Page 的 Contradictions 节记录，协调方案为按 Divio 体系分工；log.md已追加。 + +## [2026-05-01] ingest | Backend Architect Agent Personality +- Status: ✅ 成功摄入 +- Summary: Backend Architect AI Agent 人格定义——专注于可扩展系统设计、数据库架构、API 开发与云基础设施的高级后端架构师。核心理念：安全性优先、性能意识、可靠性至上。核心交付物：System Architecture Specification（模式选型矩阵）、Database Schema（含 PostgreSQL + 索引优化）、API Design（含 Express.js 安全中间件）。与 [[engineering-software-architect]] 共享架构思维但抽象层次不同（实现细节 vs 领域边界）；与 [[backend-architect-with-memory]] 在知识持久化方式上互补（文档传递 vs MCP Memory 自动召回）。 +- Concepts: MicroservicesArchitecture / CQRS / EventSourcing / ServerlessArchitecture / DatabaseIndexing / CircuitBreaker / DefenseInDepth / Event-DrivenArchitecture / API-Versioning / HorizontalScaling — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: SoftwareArchitect / MobileAppBuilder / GodotMultiplayerEngineer / AutonomousOptimizationArchitect / SRE — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-backend-architect.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-backend-architect.md）；index.md已更新（Sources 节第7行，新增条目）；overview.md第75行后新增条目；所有 Concept 和 Entity 均仅提及1次，无需独立页面；冲突检测：与 backend-architect-with-memory（知识持久化方式）和 engineering-software-architect（抽象层次）的差异已记录在 Contradictions 节；log.md已追加。 + + +## [2026-05-01] ingest | Filament Optimization Specialist Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-filament-optimization-specialist.md +- Status: ✅ 成功摄入 +- Summary: Filament PHP 管理后台的结构性优化专家 Agent——专注于高影响力布局重构（Tab/Grid/Collapsible）而非装饰性改进（图标/提示文字）。核心理念：结构改变比装饰性改动价值高10倍。结构优化层次体系（按优先级）：Tab分隔 → 并排Grid → Range Slider替换 → 可折叠区块 → Repeater itemLabel → Summary Placeholder → NavigationGroup。噪音控制：最多一层引导、图标克制、保留默认值。属 The Agency Engineering 部门，与 [[DesignUXArchitect]] 共享 UX 优化理念但专注后端管理场景。 +- Concepts: [[StructuralOptimization]] / [[FilamentPHP]] / [[RangeSliderReplacement]] / [[RepeaterItemLabel]] / [[CollapsibleSection]] / [[NavigationGrouping]] / [[NoiseCheck]] / [[PlaceholderSummary]] — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: [[FilamentOptimizationAgent]] — 仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-filament-optimization-specialist.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-filament-optimization-specialist.md）；index.md已更新（Sources 节第7行）；overview.md已更新（第73行后新增条目）；所有 Concept 和 Entity 均仅提及1次，无需独立页面；冲突检测：与一般 UI 优化观点（装饰性改进）的对比已记录在 Contradictions 节；log.md已追加。 + +## [2026-05-01] ingest | Mobile App Builder Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-mobile-app-builder.md +- Status: ✅ 成功摄入 +- Summary: Mobile App Builder Agent 人格定义——专注于原生 iOS/Android 开发和跨平台框架（Swift/SwiftUI、Kotlin/Jetpack Compose、React Native、Flutter）。核心理念：平台感知、性能优先、用户体验驱动。核心规范：遵循平台设计指南（Material Design/Human Interface Guidelines）；默认实现离线优先架构和智能数据同步；性能指标：冷启动 < 3 秒、内存 < 100MB、续航损耗 < 5%/小时。属 The Agency Engineering 部门，与 [[Software Architect]] 共享架构思维，与 [[Unity Architect]] 在跨平台理念上有分工——前者面向通用移动应用，后者面向游戏。 +- Concepts: [[MVVM]] / [[Offline-First Architecture]] / [[Cross-Platform Development]] / [[Native Mobile Development]] / [[Platform Design Guidelines]] / [[Performance Optimization]] / [[Biometric Authentication]] — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: [[SwiftUI]] / [[Jetpack Compose]] / [[React Native]] / [[Flutter]] / [[Hilt]] / [[Combine]] / [[Material Design]] / [[Human Interface Guidelines]] — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-mobile-app-builder.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-mobile-app-builder.md）；index.md已更新（第8行）；overview.md第73行条目已存在且内容一致（无需更新）；所有 Concept 和 Entity 均仅提及1次，无需独立页面；冲突检测：与 unity-architect 的跨平台理念差异已记录在 Contradictions 节（无实质冲突，属不同应用场景的合理分工）；log.md已追加。 + +## [2026-05-01] ingest | Autonomous Optimization Architect Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-autonomous-optimization-architect.md +- Status: ✅ 成功摄入 +- Summary: Autonomous Optimization Architect Agent 人格定义——AI 系统自治优化架构师，在保证财务和安全的前提下实现 LLM API 的持续自动化路由优化。核心理念：自主路由必须有熔断器兜底，否则是昂贵的炸弹。核心能力：LLM-as-a-Judge 评分、暗启动 A/B 测试、熔断器（Circuit Breaker）、成本感知语义路由。核心方法：建立数学评估标准→识别降级路径→暗启动部署→自主晋升+告警。核心交付物：Evaluation Prompts、Multi-provider Router with Circuit Breakers、Shadow Traffic 实现、Telemetry 日志。成功指标：运营成本降低 > 40%、99.99% 工作流完成率、新模型 1 小时内完成生产验证。属 The Agency Engineering 部门，与 [[Performance Benchmarker]]（传统性能测试）互补——本 Agent 专注于语义基准测试和 AI 经济优化；与 [[Tool Evaluator]]（人工驱动一次性评估）形成机器驱动持续 A/B 测试的对比。 +- Concepts created: [[Circuit-Breaker]] / [[LLM-as-a-Judge]] / [[Shadow-Traffic]] / [[Semantic-Routing]] / [[AI-FinOps]] — 均满足≥2次引用条件（source page + overview/connections），已创建独立 Concept 页面 +- Entities: [[OpenAI]] / [[Anthropic]] / [[Google-Gemini]] — 仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Entity 页 +- Source page: wiki/sources/engineering-autonomous-optimization-architect.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-autonomous-optimization-architect.md）；index.md已更新（Sources 节第9行）；5个 Concept 页面已创建（Circuit-Breaker/LLM-as-a-Judge/Shadow-Traffic/Semantic-Routing/AI-FinOps）；冲突检测：与 testing-workflow-optimizer（人工驱动 vs 机器驱动）和 tool-evaluator 的对比已记录在 Contradictions 节；log.md已追加。 + +## [2026-05-01] ingest | Software Architect Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-software-architect.md +- Status: ✅ 成功摄入 +- Summary: Software Architect Agent 人格定义——专注于系统设计、领域驱动设计、架构模式和可扩展性决策的 AI Agent。核心理念：可维护性优先于理论最优解。核心规范：反架构航天员主义（每个抽象必须证明复杂度）、权衡优先于最佳实践、领域优先于技术、ADR 记录"为什么"而非"做什么"。系统设计流程：领域发现→架构选型→质量属性分析→沟通→文档。架构模式对照：Modular Monolith（小型团队/边界不清晰）vs Microservices（领域清晰/团队自主性要求高）vs Event-driven（松耦合/异步）vs CQRS（读写不对称）。属 The Agency Engineering 部门，与 [[Backend-Architect-With-Memory]]（后端架构师，补充持久记忆能力）形成互补关系。 +- Concepts: [[ArchitectureDecisionRecord]]（已存在，已引用）/ [[DomainDrivenDesign]]（已存在，已引用）/ Bounded Context / Trade-off Matrices / CQRS / Event-driven Architecture / C4 Model — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Simon Brown（C4 Model 创建者）— 仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-software-architect.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-software-architect.md）；index.md已更新（Sources 节第7行）；ADR 和 DDD Concept 页面已存在，已在 Sources 节正确引用；冲突检测：与 Backend-Architect-With-Memory 的潜在张力已记录在 Contradictions 节（详见 source page）；overview.md 无需更新（Software Architect 属于 Engineering 分支已有覆盖范围）；log.md已追加。 + +## [2026-05-01] ingest | Godot Multiplayer Engineer Agent Personality +- Source file: Agent/agency-agents/game-development/godot/godot-multiplayer-engineer.md +- Status: ✅ 成功摄入 +- Summary: Godot 4 网络多人游戏开发 Agent 人格——精通 MultiplayerAPI、场景复制、ENet/WebRTC 传输、RPC 和权威模型。核心理念：服务器权威 + RPC 安全验证 + MultiplayerSpawner/Synchronizer 协同 + 延迟测试。核心规范：`set_multiplayer_authority()` 显式设置权威；`is_multiplayer_authority()` 守卫所有状态变更；`@rpc("any_peer")` 必须服务器端验证发送者 ID；动态节点必须用 MultiplayerSpawner 禁止手动 add_child；延迟测试必须达到 150ms 模拟延迟。核心交付物：NetworkManager.gd（ENet C/S 管理器）、服务器权威 Player 控制器（含 send_input RPC + take_damage 确认 RPC）、MultiplayerSpawner 配置示例、RPC 安全模式示例（物品拾取 + 距离验证）。高级能力：WebRTC P2P 浏览器多人（含 STUN/TURN NAT 穿透）、Nakama 游戏服务器集成、Relay 中继服务器架构、二进制数据包协议（`PackedByteArray`）+ 增量压缩。属 The Agency Game Dev 部门 Godot 专项，与 [[Godot Gameplay Scripter]]（GDScript 游戏逻辑）和 [[Godot Shader Developer]]（渲染与特效）协同构建完整 Godot 4 游戏开发栈。与 [[Unity Multiplayer Engineer]] 同属多人游戏网络专项，核心原则一致（服务器权威），但实现 API 不同。 +- Concepts created: MultiplayerAPI / Server-Authoritative Architecture / RPC / MultiplayerSpawner / MultiplayerSynchronizer / ENet / WebRTC / Authority Model / Scene Replication / Delta Compression — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Godot / Nakama / NetworkManager / Player — 均仅在本页提及，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/godot-multiplayer-engineer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/godot-multiplayer-engineer.md）；index.md已更新（第7行）；冲突检测：与 unity-multiplayer-engineer.md 存在权威模型比较（已在 Contradictions 节记录，核心原则一致，仅 API 实现不同，无实质冲突）；所有 Concept 和 Entity 均仅提及1次，无需独立页面；log.md已追加。 + + +- Source file: Agent/agency-agents/game-development/godot/godot-shader-developer.md +- Status: ✅ 成功摄入（内容更新） +- Summary: Godot 4 渲染效果专家 AI Agent——精通 Godot 着色语言（GLSL-like）、VisualShader 编辑器、CanvasItem 和 Spatial 着色器、后处理与性能优化。核心理念：创作性、正确性与性能意识三合一。核心规范：`shader_type` 声明 + uniform hint 强制 + 渲染器分级适配（Forward+ / Mobile / Compatibility）+ 纹理采样性能审计。核心交付物：2D CanvasItem 精灵描边着色器（8 邻域采样）、3D Dissolve 溶解着色器（noise + discard + 边缘自发光）、3D 水面着色器（双层法线 + 深度色彩渐变）、全屏后处理 CompositorEffect、Shader Performance Audit Checklist。属 The Agency Game Dev 部门 Godot 专项，与 [[Godot Gameplay Scripter]]（GDScript 游戏逻辑）协同构建完整 Godot 4 游戏开发栈。 +- Concepts: CanvasItem Shader / Spatial Shader / VisualShader / CompositorEffect / Forward+ Renderer / Mobile Renderer / Compatibility Renderer / RenderingDevice — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Godot / GLSL — 均仅在本页提及，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/godot-shader-developer.md +- Notes: 步骤1-9全部完成；source page已重新生成（wiki/sources/godot-shader-developer.md）；index.md第494行条目已存在（无需更新）；overview.md第1104-1112行条目已存在且内容一致（无需更新）；所有 Concept 和 Entity 均仅提及1次，无需独立页面；Connections 已记录（4条）；Contradictions 已记录（无冲突）；log.md已追加。 + +## [2026-05-01] ingest | Roblox Avatar Creator Agent Personality +- Source file: Agent/agency-agents/game-development/roblox-studio/roblox-avatar-creator.md +- Status: ✅ 成功摄入 +- Summary: Roblox UGC 化身 pipeline 专家 AI Agent——掌握从建模到 Creator Marketplace 提交的完整 Avatar 物品制作流程。核心规范：UGC 网格三角面数硬限制（配件 ≤4,000）；单 UV 通道 [0,1] 范围；纹理 256×256~1024×1024 PNG；Layered Clothing 必须有 Outer Mesh + InnerCage + OuterCage 三层 cage；附件点标准命名（R15 兼容性）；HumanoidDescription API 游戏内换装。核心交付物：Accessory Export Checklist、AvatarManager.lua、Layered Clothing Cage Setup Guide、Creator Marketplace Submission Package、UGC Shop UI Flow。 +- Concepts: UGC / Layered Clothing / R15 Avatar Rig / HumanoidDescription / Creator Marketplace / Cage Mesh / Rthro Avatar Scale / Blender R15 Rig — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Source page: wiki/sources/roblox-avatar-creator.md +- Notes: overview.md 第 1022 行已存在 roblox-avatar-creator 条目，内容与本次摄入一致，无需更新。冲突检测：无内容冲突。 + +## [2026-05-01] ingest | Roblox Systems Scripter +- Source file: Agent/agency-agents/game-development/roblox-studio/roblox-systems-scripter.md +- Status: ✅ 成功摄入 +- Summary: Roblox Systems Scripter Agent——Roblox 平台系统工程专家 AI Agent，专精 Luau 编程、服务器权威模型、RemoteEvent/RemoteFunction 安全架构、DataStore 持久化与模块化代码组织。核心理念：服务器是唯一真相来源，客户端只展示状态不拥有状态。核心规范：客户端→服务器请求必须完整验证（类型+冷却+距离+权限）；DataStore 必须 pcall 保护+指数退避重试（2s/4s/8s）+双保存点（PlayerRemoving+BindToClose）；所有游戏逻辑封装在 ModuleScript 返回表；RemoteFunction InvokeClient 禁止在服务器调用（恶意客户端可永久挂起线程）。核心交付物：DataManager.lua（含 retryAsync+deepCopy+双保存点）、CombatSystem.lua（完整验证链路示例）、GameServer.bootstrap.server.lua（五阶段引导模式）。高级能力：Parallel Luau（task.desynchronize+Actor+SharedTable）、对象池化（预实例化 effects/NPC）、数据版本迁移（data._version+UpdateAsync 原子升级）、ServiceLocator 依赖注入、FeatureFlags 特性开关。属 The Agency Game Dev 部门 Roblox Studio 专项，与 [[Roblox Experience Designer]]（玩家参与度和变现系统设计）协同构成完整 Roblox 开发体系。 +- Concepts: ServerAuthoritativeModel / RemoteEvent / RemoteFunction / DataStore / ModuleScript / ParallelLuau / ObjectPooling / ServiceLocator / FeatureFlags / ActorModel / UpdateAsync / SessionLocking — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: RobloxSystemsScripter / RobloxPlatform / Luau / DataStoreService / ReplicatedStorage / ServerStorage / Players / BindableEvent — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/roblox-systems-scripter.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/roblox-systems-scripter.md）；index.md第7行条目已补充；overview.md第1011行条目已存在并覆盖完整（无需更新）；所有 Concept 和 Entity 均仅提及1次，无需独立页面；Connections 已记录（RobloxSystemsScripter extends RobloxExperienceDesigner + 6个依赖关系）；Contradictions 已记录（vs UnrealMultiplayerArchitect 权威模型差异 + vs UnityMultiplayerEngineer 帧率同步差异）；log.md已追加。 + +## [2026-05-01] ingest | Roblox Experience Designer +- Source file: Agent/agency-agents/game-development/roblox-studio/roblox-experience-designer.md +- Status: ✅ 成功摄入（内容更新） +- Summary: Roblox Experience Designer Agent——Roblox 平台原生体验设计师 AI Agent 更新版。核心方法新增：每日奖励系统（7天循环阶梯，第7天含徽章奖励）、入职引导三阶段含流失恢复策略（<2分钟=引导过慢/5-7分钟=奖励不够吸引/>15分钟=缺少返回钩子）、Roblox SEO 三要素。高级能力新增：Live Ops 事件运营（ReplicatedStorage 配置对象 + 服务器重启实现限时活动）；高级分析（A/B 测试基础设施 math.random() 按 UserId 分配桶、队列元数据 Cohort 分析、HttpService 导出外部 BI）；社会化系统（好友邀请 GetFriendsAsync、Group 门控 GetRankInGroup、Lobby 实时在线人数）；变现优化（软货币首次购买漏斗、价格锚定、购买遗弃提醒）。核心交付物新增：DailyRewardSystem.lua（7天奖励阶梯）、Onboarding Flow Design Document、Retention Metrics Tracking（AnalyticsService 事件）。成功指标：D1 留存 >30%、D7 >15%、MAU 月增长 >10%、转化率 >3%、零 Roblox 政策违规。 +- Concepts: EngagementLoop / DailyRewardSystem / DataStoreDrivenProgression / GamePassMonetization / DeveloperProduct / UGCMonetization / OnboardingFlow / RobloxAlgorithm / AnalyticsService / SoftCurrencyFunnel / PriceAnchoring / LiveOperations / PurchaseAbandonmentRecovery / GroupGating / ABTestingInfrastructure — 均仅在本页提及1次或已在其他页引用，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: RobloxExperienceDesigner / RobloxPlatform / MarketplaceService / DataStoreService / AnalyticsService / ReplicatedStorage / Players / HttpService — 均仅在本页提及1次或已在其他页引用，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/roblox-experience-designer.md +- Notes: 步骤1-9全部完成；source page已存在（本次为内容更新，完全重写）；index.md第490行条目已补充日期[2026-05-01]和摘要；overview.md第1020行条目已增强，新增高级能力四模块（Live Ops/高级分析/社会化系统/变现优化）和流失恢复策略细节；所有 Concept 和 Entity 均仅提及1次，无需独立页面；Connections 已更新（新增 ReplicatedStorage/LiveOperations/Players/HttpService 连接）；Contradictions 已更新（新增 vs RobloxSystemsScripter 互补关系说明）；log.md 已追加。 + +## [2026-05-01] ingest | Unity Shader Graph Artist +- Source file: Agent/agency-agents/game-development/unity/unity-shader-graph-artist.md +- Status: ✅ 成功摄入 +- Summary: Unity Shader Graph Artist Agent——Unity渲染效果专家AI Agent，专精Shader Graph可视化材质创作与HLSL性能优化，覆盖URP/HDRP渲染管线的实时视觉效果开发。核心理念：Shader Graph是艺术家创作首选工具，HLSL仅用于性能关键路径。核心规范：Sub-Graph强制复用重复逻辑；URP/HDRP API严格区分（ScriptableRendererFeature vs CustomPassVolume）；移动端性能硬约束（≤32纹理采样/≤60 ALU）；Alpha Clipping优先于Alpha Blend；Frame Debugger强制性能分析。核心交付物：Dissolve Shader Graph（含Sub-Graph封装的DissolveCore）、OutlineRendererFeature（URP自定义描边通道）、CustomLit.hlsl（URP兼容PBR完整示例）、Shader Complexity Audit模板。高级能力：Compute Shader GPU处理、RenderDoc调试、自定义深度后处理通道、程序化纹理生成。 +- Concepts created/updated: Shader（更新sources和last_updated）/ URP（新建）/ HDRP（新建）——均已写入wiki/concepts/ +- Entities created/updated: Unity（新建）——已写入wiki/entities/ +- Source page: wiki/sources/unity-shader-graph-artist.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/unity-shader-graph-artist.md）；index.md第486行条目已补充日期和摘要；overview.md第1064行条目已覆盖全部新增内容，无需修订；新增3个Concept页（Shader更新/URP新建/HDRP新建）；index.md Entities节补充Unity（第1004行），Concepts节补充HDRP（第2029行）和URP（第2030行）；Connections已记录（UnityShaderGraphArtist↔Unity↔Shader↔URP↔HDRP）；Contradictions章节记录URP/HDRP API不兼容特性；log.md已追加。 + +## [2026-05-02] ingest | Code Reviewer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-code-reviewer.md +- Status: ✅ 成功摄入 +- Summary: Code Reviewer AI Agent 人格定义——专注于代码审查与质量保证，提供构造性、可操作的反馈，聚焦正确性、安全性、可维护性、性能四大维度。核心理念：像导师而非门卫一样审查，每次评论都教授知识。审查清单三层优先级：🔴 Blocker（安全漏洞/数据损坏/竞态条件/破坏API合约/缺失关键路径错误处理）、🟡 Suggestion（缺失输入验证/命名混乱/缺失测试/N+1查询/代码重复）、💭 Nit（风格不一致/小幅命名改进/文档缺口）。与 [[SoftwareArchitect]] 和 [[BackendArchitect]] 协同，与 [[QualityGate]] 构成质量保障双层。属 The Agency Engineering 部门。 +- Concepts: CodeReview / SecurityAudit / PerformanceProfiling / Mentorship / ReviewChecklist — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: CodeReviewerAgent — 仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-code-reviewer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-code-reviewer.md）；index.md已更新（Sources 节第11行，新增条目）；overview.md第77行后新增条目；所有 Concept 和 Entity 均仅提及1次，无需独立页面；冲突检测：与 linter（风格审查工具）的差异已记录在 Contradictions 节（审查负责人工判断，linter 负责格式自动化）；log.md已追加。 + +- Source file: Agent/agency-agents/game-development/godot/godot-gameplay-scripter.md +- Status: ✅ 成功摄入 +- Summary: Godot Gameplay Scripter Agent——Godot 4 游戏玩法脚本专家 AI Agent，专注于用 GDScript 2.0 和 C# 构建类型安全、信号驱动的游戏系统。核心理念：一切皆为节点，行为通过组合而非继承实现。核心规范：GDScript 信号 snake_case + 类型化参数；C# 信号 PascalCase + EventHandler 模式；静态类型强制（无未类型化 var）；组合优于继承（HealthComponent/MovementComponent）；Autoload 仅作全局状态服务定位器；场景必须可独立运行（F6）。核心交付物：Typed Signal 声明（GDScript + C#）、EventBus Autoload、HealthComponent 组件模式、Typed Array 敌人追踪、GDScript/C# 跨语言信号连接。高级能力：GDExtension C++ 集成、RenderingServer 低级 API、Service Locator + 优先级事件总线、场景池化、WebRTC P2P 多人游戏、Nakama 集成、延迟补偿。属 The Agency Game Dev 部门 Godot 专精，与 [[GodotShaderDeveloper]] + [[GodotMultiplayerEngineer]] 协同构成完整 Godot 4 开发体系。 +- Concepts: GDScript-2.0 / TypedSignals / CompositionOverInheritance / EventBus / StaticTyping / GDExtension / RenderingServer / SceneTreeLifecycle — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: GodotGameplayScripter / GodotEngine / GDScript / CSharpGodot — 均仅提及1次，不满足≥2次条件，无需独立 Entity 页 +- Source page: wiki/sources/godot-gameplay-scripter.md +- Notes: 步骤1-9全部完成；source page 为新建（wiki/sources/godot-gameplay-scripter.md）；index.md 第495行条目已补充日期[2026-05-02]和摘要；overview.md 第1086行条目已存在并覆盖完整（无需更新）；所有 Concept 和 Entity 均仅提及1次，无需独立页面；Contradictions 已记录（vs UnrealSystemsEngineer Autoload vs Actor/Component 差异）；Connections 已记录（与 GodotShaderDeveloper + GodotMultiplayerEngineer 协同关系）；log.md 已追加。 + +## [2026-05-01] ingest | Unity Editor Tool Developer +- Source file: Agent/agency-agents/game-development/unity/unity-editor-tool-developer.md +- Status: ✅ 成功摄入 +- Summary: Unity Editor Tool Developer Agent——Unity 编辑器扩展开发工程师 AI Agent，构建 EditorWindows / AssetPostprocessors / PropertyDrawers / Build Validators 等自动化工具，核心理念"最佳工具是隐形的"。核心规范：Editor 脚本必须置于 Editor 文件夹或 #if UNITY_EDITOR 保护；EditorWindow 必须持久化状态（[SerializeField]/EditorPrefs）且长操作必须 DisplayProgressBar；AssetPostprocessor 必须幂等；PropertyDrawer 必须调用 BeginProperty/EndProperty；构建失败必须抛出 BuildFailedException 而非 LogWarning。核心交付物：AssetAuditWindow / TextureImportEnforcer / FloatRangeDrawer / BuildValidationProcessor。高级能力：Assembly Definition 架构 / CI/CD 集成 / Scriptable Build Pipeline / UI Toolkit 迁移。 +- Concepts: EditorWindow / PropertyDrawer / AssetPostprocessor / AssemblyDefinition / Undo / BuildValidation / ScriptableBuildPipeline / UI-Toolkit — 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: UnityEditorToolDeveloper — 仅提及1次，不满足≥2次条件，无需独立 Entity 页 +- Source page: wiki/sources/unity-editor-tool-developer.md +- Notes: 步骤1-9全部完成；source page 为新建（wiki/sources/unity-editor-tool-developer.md）；index.md 第487行条目已补充日期[2026-04-26]；overview.md 第1055行条目已存在并已增强，新增核心交付物列表和高级能力（Assembly Definition架构/CI/CD集成/ScriptableBuildPipeline/UI Toolkit迁移）描述；Contradictions 章节记录与[[UnrealTechnicalArtist]]的编辑器扩展方案差异；log.md 已追加。 + +- Source file: Agent/agency-agents/game-development/unreal-engine/unreal-systems-engineer.md +- Status: ✅ 成功摄入 +- Summary: Unreal Systems Engineer Agent——UE5 系统架构工程师 AI Agent 人格规范更新。C++/Blueprint 边界核心原则：Tick 逻辑必须 C++（Blueprint VM 开销产生 ~10x 性能差距）；Nanite 实例预算（单场景上限 1600 万，植被密度 500m 视距内超出上限）；内存安全（UPROPERTY 强制声明、IsValid() 检查、TWeakObjectPtr/TSharedPtr 非拥有引用）；GAS 网络复制（.Build.cs 三模块、AttributeSet 含 RepNotify、FGameplayTag 替代字符串）；Unreal Build System 反射宏规范。高级能力新增：Mass Entity（FMassFragment + FMassTag + UMassRepresentationSubsystem）、Chaos 破坏系统（Geometry Collection + constraint 类型）、Lyra 模块化框架（GameFeatureAction + Experience 模式切换）。 +- Concepts: Chaos-Physics（新建）/ Mass-Entity（新建）/ Nanite（已存在，更新 sources 和 last_updated）/ GAS（更新 last_updated）——均已写入 wiki/concepts/ +- Entities: UnrealEngine5（更新 last_updated）/ UnrealMultiplayerArchitect / UnrealTechnicalArtist — 均已存在于 wiki/entities/，无需新建 +- Source page: wiki/sources/unreal-systems-engineer.md +- Notes: 步骤1-9全部完成；source page已存在（本次为内容更新，完全重写）；index.md第484行条目已补充日期[2026-05-30]；overview.md第1032行条目已更新，新增Blueprint Tick ~10x性能差距、Nanite显式切线禁止规则、.Build.cs三模块要求、反射宏静默失败警告、Mass/Chaos/Lyra详细规范；新增3个Concept页（Chaos-Physics/Mass-Entity/Nanite更新）；index.md Concepts节补充Chaos-Physics（第1271行）和Mass-Entity（第1754行）；Contradictions章节记录与[[UnrealMultiplayerArchitect]]的GAS职责边界冲突；log.md已追加。 +- Source file: Agent/agency-agents/game-development/unreal-engine/unreal-technical-artist.md +- Status: ✅ 成功摄入 +- Summary: Unreal Technical Artist Agent——UE5 视觉系统工程师 Agent，专注 Material Editor / Niagara VFX / PCG / Nanite / HLOD / Substrate 全栈管线。核心原则：可复用逻辑进入 Material Function（避免 permutation 爆炸）、Niagara GPU/CPU 选型前置于构建、PCG 确定性图、HLOD 覆盖所有 World Partition 开放世界区域。性能纪律：Max Particle Count 必设、Static Switch 双重 permutation 计数、材质 instruction 预算分级（mobile<200/console<400/PC<800）。 +- Concepts: MaterialFunction / NiagaraScalability / PCG / Nanite / HLOD / Substrate — 均已存在于 wiki/concepts/，无需新建 +- Entities: 无满足≥2次条件的 Entity，无需独立页面 +- Source page: wiki/sources/unreal-technical-artist.md +- Notes: 步骤1-9全部完成；source page已存在（本次为内容更新，完全重写）；index.md第482行条目已补充日期[2026-04-30]；overview.md第1028行条目已覆盖全部新增内容，无需修订；所有关键Concept（MaterialFunction/NiagaraScalability/PCG/Nanite/HLOD/Substrate）均已存在于wiki/concepts/，已在Source Page中以wikilink引用；3组Connections（UnrealWorldBuilder/UnrealSystemsEngine/UnrealMultiplayerArchitect）和1组Contradiction（vs TechnicalArtist）已记录；log.md已追加。 + + +- Source file: Agent/agency-agents/game-development/narrative-designer.md +- Status: ✅ 成功摄入 +- Summary: Narrative Designer Agent——将游戏叙事理解为一套由选择、后果和世界一致性构成的系统，而非插入在玩法之间的电影剧本。核心交付物：三-tier Lore架构（Surface/Engaged/Deep）、Voice Pillars角色声音定义、分支节点映射、叙事-玩法对齐矩阵、环境叙事简报。强调Engine-ready格式（Ink/Yarn）从第一天开始写作，避免剧本到脚本翻译层。 +- Concepts: Branching-Dialogue-Design / Voice-Pillars / Lore-Architecture / Environmental-Storytelling / Emergent-Narrative / Choice-Architecture — Environmental-Storytelling已存在于wiki/concepts/，其余5个在本页首次引入但均仅提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Concept页 +- Entities: NarrativeDesigner — 仅提及1次，不满足≥2次条件，无需独立Entity页 +- Source page: wiki/sources/narrative-designer.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/narrative-designer.md）；index.md第490行条目已补充日期[2026-05-07]；5个Key Concepts（Branching-Dialogue-Design/Voice-Pillars/Lore-Architecture/Emergent-Narrative/Choice-Architecture）和1个Key Entity（NarrativeDesigner）均仅提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用；Environmental-Storytelling已存在于concepts目录；4组Connections（Game Designer/Technical Artist/Game Audio Engineer/Level Designer）均仅提及1次，不满足Entity页创建条件；无冲突记录；log.md已追加。 + +## [2026-05-07] ingest | Level Designer Agent Personality +- Source file: Agent/agency-agents/game-development/level-designer.md +- Status: ✅ 成功摄入 +- Summary: Level Designer Agent——将走廊视为句子、房间视为段落、关卡视为完整论点的空间叙事专家。六阶段工作流（意图定义→纸面布局→灰盒→遭遇战调优→美术交接→打磨）；节奏控制通过 Pacing Chart 实现；遭遇战三要素（进入读时+多种战术选项+撤退位置）；灰盒阶段锁定设计决策，美术美化零例外必须先通过灰盒测试；高级能力涵盖 Prospect-Refuge 空间心理学、程序化关卡设计、Kevin Lynch 城市设计五要素、多人空间设计。 +- Concepts: Pacing-Chart / Grey-Box-Blockout / Encounter-Design / Environmental-Storytelling / Spatial-Psychology — Pacing-Chart（新建）、Grey-Box-Blockout（新建）；Encounter-Design、Environmental-Storytelling、Spatial-Psychology 均已存在，无需更新 +- Source page: wiki/sources/level-designer.md +- Notes: 步骤1-9全部完成；source page已存在（本次为内容更新，完全重写）；index.md第490行条目已补充日期[2026-05-07]；overview.md第1024行game-designer条目之后新增level-designer条目；新增5个Concept页面（Pacing-Chart/Grey-Box-Blockout/Encounter-Design/Environmental-Storytelling/Spatial-Psychology），其中Encounter-Design/Environmental-Storytelling/Spatial-Psychology已存在于index和concepts目录，仅需补充sources引用；index.md补充Pacing-Chart和Grey-Box-Blockout条目；Contradictions章节记录与[[Technical Artist]]的美术交接冲突（gameplay-critical vs dressable标注）；log.md已追加。 + +## [2026-05-30] ingest | Technical Artist +- Source file: Agent/agency-agents/game-development/technical-artist.md +- Status: ✅ 成功摄入 +- Summary: 技术美术 Agent 个性定义更新——新增粒子系统 Max Particle Count 上限强制要求、AI 辅助美术管线（纹理超分/ML去噪/DLSS）、着色器参数 tooltip 文档规范、VFX profiling 场景构建要求、纹理图集（Texture Atlasing）规范。共 8 个 Key Claims（含原 4 个）、13 个 Key Concepts（含新增 3 个）、7 个 Key Entities（含新增 2 个）、10 组 Connections（含新增 3 组）。 +- Concepts: MachineLearningArtPipeline / TextureAtlasing / ToolDevelopment — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Concept页 +- Entities: GodotShaderDeveloper / BlenderAddonEngineer — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Entity页 +- Source page: wiki/sources/technical-artist.md +- Notes: 步骤1-9全部完成；source page已存在（本次为内容更新），新增4个Key Claims、3个Key Concepts（MachineLearningArtPipeline/TextureAtlasing/ToolDevelopment）、2个Key Entities（GodotShaderDeveloper/BlenderAddonEngineer）、3组新Connections；index.md第485行条目已存在，无需更新；overview.md第1000行条目已覆盖新增高级能力，无需修订；Entity和Concept均不满足≥2次条件，无需独立页面；log.md已追加。 + +## [2026-05-30] ingest | Marketing Growth Hacker Agent +- Source file: Agent/agency-agents/marketing/marketing-growth-hacker.md +- Status: ✅ 成功摄入 +- Summary: 增长黑客专家 Agent——数据驱动的增长实验 + K-factor > 1.0 病毒式传播 + 北极星指标体系 + LTV:CAC ≥ 3:1 单位经济学 + AARRR 漏斗全链路优化。核心竞争力：发现无人涉足的流量渠道并规模化复制，而非砸钱买广告。成功指标：月增长 20%+、K-factor > 1.0、CAC 回本 < 6 个月、实验速度 10+/月。 +- Concepts: GrowthFunnelOptimization / ViralLoop / NorthStarMetric / KFactor / CACandLTV / ProductLedGrowth — 均已存在，无需新建或更新（其中 GrowthFunnelOptimization / ViralLoop / NorthStarMetric / KFactor / CACandLTV / ProductLedGrowth 在其他来源中已创建独立页面） +- Source page: wiki/sources/marketing-growth-hacker.md +- Notes: 步骤1-9全部完成；source page 已存在（步骤3无需新建），index.md 第472行原有条目已补充日期和一行摘要；overview.md 第857行已有详细条目（Marketing Agents部分），内容一致，无需更新；Entity（Growth Hacker Agent / The Agency）仅在本页提及1次，不满足≥2次创建条件，已在Source Page中引用；所有6个 Key Concepts 均已存在独立页面，无需新建；Contradictions 节记录与 [[MarketingTikTokStrategist]] 的渠道优先级冲突（实验数据驱动 vs 平台内容优先）；log.md 已追加。 + +## [2026-05-30] ingest | Marketing Xiaohongshu Specialist +- Source file: Agent/agency-agents/marketing/marketing-xiaohongshu-specialist.md +- Status: ✅ 成功摄入 +- Summary: 小红书（中国生活方式种草平台）爆款品牌营销专家 Agent——通过生活方式品牌定位 + 趋势驱动内容策略 + 微内容优化 + 社区互动 + 数据迭代五阶段工作流，将品牌打造为小红书顶流。核心内容配比：70% 有机生活内容 + 20% 趋势参与 + 10% 品牌直接推广。关键指标：互动率 5%+、评论转化 30%+、分享率 2%+、收藏率 8%+、CTR 3%+。 +- Entities: XiaohongshuPlatform / GenZMillennials / MicroInfluencer / KOLKOC — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Entity页面 +- Concepts: LifestyleBrandPositioning / TrendRiding / MicroContentOptimization / CommunityFirstEngagement / UGCCampaign / MicroInfluencerPartnership / ContentMixStrategy — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Concept页面 +- Source page: wiki/sources/marketing-xiaohongshu-specialist.md +- Notes: 步骤1-9全部完成；source page 已存在（步骤3无需新建），index.md 第471行原有条目，log.md 追加记录；overview.md 已通过关联 Agent（China Market Localization Strategist 等）提及小红书，无需单独修订；Entity 和 Concept 均不满足≥2次创建条件，无需独立页面；与 [[MarketingTikTokStrategist]] 的视频时长偏好冲突已在 Contradictions 章节记录。 + +## [2026-05-30] ingest | Marketing Podcast Strategist +- Source file: Agent/agency-agents/marketing/marketing-podcast-strategist.md +- Status: ✅ 成功摄入 +- Summary: 中国播客内容策略与全漏斗运营专家 Agent——涵盖节目定位（小宇宙/喜马拉雅等平台差异化运营）、音频制作（-16 LUFS标准）、受众增长（社群运营/跨平台引流/嘉宾互推）、多平台分发（RSS同步+手动上传）、商业化变现（品牌赞助→付费订阅→知识付费→私域导流）。核心理念：播客是"慢媒介"，核心竞争力是主播人格深度，完成率比播放量更能反映内容质量。 +- Entities: Xiaoyuzhou / Ximalaya / LizhiFM / QingtingFM / ShureSM7B — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Entity页面 +- Concepts: PodcastFormatTypes / PodcastMonetization / PodcastDistribution / AudienceGrowthStrategy / AudioProduction — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Concept页面 +- Source page: wiki/sources/marketing-podcast-strategist.md +- Notes: 步骤1-9全部完成；source page已创建，含6个Key Claims（中文）、4个Key Quotes、5个Key Concepts（wikilink格式）、5个Key Entities（wikilink格式）、6组Connections（wikilink格式）、0组Contradiction（与同系列其他Agent互补无冲突）；index.md第471行原有条目已补充日期和摘要；overview.md第1144行已有详细条目（"播客'慢媒介' vs 短视频'快媒介'"部分），内容一致，无需更新；Entity和Concept均不满足≥2次条件，无需独立页面；log.md已追加。 + +## [2026-04-26] ingest | Marketing TikTok Strategist +- Source file: Agent/agency-agents/marketing/marketing-tiktok-strategist.md +- Status: ✅ 成功摄入 +- Summary: TikTok 病毒式内容创作与品牌增长专家 Agent 人格定义——3秒黄金钩子法则、For You Page 算法优先策略、创作者分层合作体系（Nano/Micro/Mid-tier/Macro）、40/30/20/10 内容配比框架。核心指标：参与率 8%+、完播率 70%+、品牌标签挑战 1M+ 浏览、KOL 合作 ROI 4:1。 +- Entities: TikTok / Instagram Reels / YouTube Shorts / TikTok-Ads / ByteDance / Douyin — 均已存在，无需新建或更新 +- Concepts: For You Page 算法 / 内容支柱 / 参与速度 / 创作者分层 / 病毒公式 / TikTok 广告格式 — 均为平台操作方法而非独立可复用概念，无需新建独立页面 +- Source page: wiki/sources/marketing-tiktok-strategist.md +- Notes: 步骤1-9全部完成；source page 已创建，含6个 Key Claims、4个 Key Quotes、6个 Key Concepts（wikilink）、5个 Key Entities（wikilink）、5条 Connections、1条 Contradiction（与 [[Marketing-Douyin-Strategist]] 的平台算法差异）；index.md 第467行原有条目，补充日期 [2026-04-26]；overview.md 无需更新（TikTok 相关内容已散见于其他条目）；Entity 和 Concept 均不满足≥2次创建条件，无需独立页面；log.md 已追加。 + +## [2026-05-20] ingest | Marketing SEO Specialist +- Source file: Agent/agency-agents/marketing/marketing-seo-specialist.md +- Status: ✅ 成功摄入 +- Summary: SEO专家Agent人格定义——通过技术SEO、内容策略和链接权威建设实现可持续的有机搜索增长。五阶段工作流程（发现→关键词策略→站内优化→权威建设→测量迭代）；强制性cannibalization审查防止关键词冲突；E-E-A-T合规标准；Core Web Vitals基准（LCP<2.5s，INP<200ms，CLS<0.1）。交付物：技术SEO审计模板、关键词策略文档、内容cannibalization审查表、页面优化清单、链接建设方案。 +- Concepts: KeywordCannibalizationAudit / TopicClusterArchitecture / E-E-A-TCompliance / CoreWebVitals / TechnicalSEOAudit / LinkAuthorityBuilding / SearchIntentMapping / SERPFeatureOptimization — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Concept页 +- Entities: SchemaMarkup / GoogleSearchConsole / ScreamingFrog / LookerStudio — 均仅提及1次，不满足≥2次创建条件，已在Source Page中引用 +- Source page: wiki/sources/marketing-seo-specialist.md +- Notes: 步骤1-9全部完成；source page已生成，含8个Key Concepts（wikilink格式）、5个Key Entities（wikilink格式）、6个Key Claims、4个Key Quotes、4组Connections、1组Contradiction；index.md第467行已有条目（Marketing SEO Specialist），确认内容正确；overview.md第903行已有详细条目（Marketing Agents部分），本次确认内容一致；Contradiction记录与[[MarketingGrowthHacker]]的快速增长vs可持续性策略张力；Entity和Concept均不满足≥2次条件，无需独立页面；log.md已追加。 + +## [2026-05-29] ingest | Marketing Content Creator +- Source file: Agent/agency-agents/marketing/marketing-content-creator.md +- Status: ✅ 成功摄入 +- Summary: 多平台营销内容创作专家Agent人格定义——专注于跨平台品牌内容策略制定、叙事构建和受众互动优化。核心能力：内容策略框架（编辑日历+内容支柱+受众优先规划）、多格式创作（图文/视频脚本/播客/信息图）、品牌叙事、SEO内容优化（目标有机流量+40%）、视频制作全链路（目标完播率70%+）、绩效分析与ROI测量（目标5:1）。成功指标：参与率25%+、视频完播率70%+、内容驱动线索生成+300%、内容ROI 5:1。 +- Concepts: ContentStrategy / BrandStorytelling / SEOContent / VideoProduction / ContentRepurposing / ContentAutomation — 均仅在本页提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Concept页 +- Entities: （无特定外部实体，本文档为纯方法论文档，无需创建Entity页面） +- Source page: wiki/sources/marketing-content-creator.md +- Notes: 步骤1-9全部完成；source page已生成，含5个Key Claims、2个Key Quotes、6个Key Concepts（wikilink格式）、0个Key Entities、5组Connections、0组Contradiction；index.md第471行已有条目（Marketing Content Creator），确认内容正确；overview.md第854行已有详细条目（Marketing Agents部分），本次确认内容一致；Entity和Concept均不满足≥2次条件，无需独立页面；log.md已追加。 + +## [2026-05-19] ingest | China Market Localization Strategist +- Source file: Agent/agency-agents/marketing/marketing-china-market-localization-strategist.md +- Status: ✅ 成功摄入 +- Summary: 中国市场全方位本地化增长策略专家 Agent，将实时趋势信号（抖音热榜/B站热门/微博热搜等）转化为可执行的选品、内容和渠道策略。核心框架：Trend-to-Action 双轨分析（内容轨+评论轨）、P0-P5 六阶段 GTM 门控模型、跨平台差异化策略（抖音/小红书/微信/B站/微博/知乎）、私域运营闭环。适配 1-3 人小团队，强调数据驱动决策、文化深度本地化和闭环迭代。 +- Entities created: [[Bilibili]]（B站，Z世代深度内容平台，营销漏斗"考虑"角色） +- Entities updated: [[Douyin]]（sources 字段追加 marketing-china-market-localization-strategist） +- Concepts created: [[GTM-Phase-Gate]]（P0-P5 六阶段产品上市门控模型） +- Concepts updated: [[私域运营]]（sources 字段追加 marketing-china-market-localization-strategist） +- Source page: wiki/sources/marketing-china-market-localization-strategist.md +- Notes: 步骤1-9全部完成；source page 已创建，含6个 Key Concepts（wikilink）、10个 Key Entities（wikilink）、4条 Key Claims、4条 Key Quotes、8条 Connections、1条 Contradiction；index.md Entities 节新增 Bilibili 条，Concepts 节新增 GTM-Phase-Gate 条；Trend-To-Action 概念已存在（来源一致，无需新建）；Contradictions 节记录与 [[Marketing Douyin Strategist]] 的跨平台 vs 单平台策略张力；log.md 已追加。 + +## [2026-05-20] ingest | Marketing Twitter Engager +- Source file: Agent/agency-agents/marketing/marketing-twitter-engager.md +- Status: ✅ 成功摄入 +- Summary: Twitter 实时互动与思想领袖建立专家 Agent，通过真实对话参与、领袖思想内容创作和社区驱动增长构建品牌权威。四阶段工作流（实时监控→思想领袖开发→社区建设→效果优化）；内容配比策略（教育25%/个人故事20%/行业评论20%/社区互动15%/推广10%/娱乐10%）；Twitter Spaces 定期举办（200+ 听众）；危机管理 <30 分钟响应。核心指标：互动率 ≥2.5%、回复率 80%（2小时内）、教育 thread ≥100 转推。 +- Entities: Twitter / Twitter Spaces / Twitter Ads — 均为知名平台，无独立 Entity 页面 +- Concepts: ThoughtLeadership / CommunityBuilding / CrisisManagement / EngagementRate / TwitterSpacesStrategy / ThreadMastery — 均在本页首次引入，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立页面 +- Source page: wiki/sources/marketing-twitter-engager.md +- Notes: 步骤1-9全部完成；source page 已创建，含6个 Key Claims、1个 Key Quote、6个 Key Concepts（wikilink）、3个 Key Entities（wikilink）、3条 Connections、1条 Contradiction（无冲突）；index.md 已更新（第468行补充日期和摘要）；overview.md 已有详细条目（第862行），无需更新；Entity 和 Concept 均不满足≥2次条件，无需独立页面；log.md 已追加。 + +## [2026-05-19] ingest | App Store Optimizer +- Source file: Agent/agency-agents/marketing/marketing-app-store-optimizer.md +- Status: ✅ 成功摄入 +- Summary: App Store 优化（ASO）全栈专家 Agent，专注于应用商店搜索可见性优化、视觉资产转化率提升和可持续用户增长。核心理念：数据驱动决策 + 转化优先设计哲学 + 系统性 A/B 测试 + 国际化本地化策略。绩效指标：有机下载月增长 30%+、关键词前10排名 20+、转化率提升 25%+、评分 4.5 星+。四阶段工作流：市场研究分析 → 策略开发 → 实施测试 → 优化规模化。 +- Concepts: App Store Optimization（ASO）/ Conversion Rate Optimization / A/B Testing / Keyword Research / Visual Asset Optimization / App Localization / Review Management — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: App Store（iOS）/ Google Play（Android）— 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-app-store-optimizer.md +- Notes: 步骤1-9全部完成；index.md 第472行已有条目（App Store Optimizer），确认内容正确；overview.md 第901行已有详细条目（Marketing Agents 部分），确认内容一致；Contradictions 与 [[Marketing Social Media Strategist]] 的策略张力（创意自由 vs 数据约束）记录在案，协调为互补关系（ASO 优化漏斗顶层，社媒策略负责中层品牌认知）；Entity 和 Concept 均不满足≥2次条件，无需独立页面；log.md 已追加。 + +## [2026-05-17] ingest | LinkedIn Content Creator +- Source file: Agent/agency-agents/marketing/marketing-linkedin-content-creator.md +- Status: ✅ 成功摄入 +- Summary: LinkedIn 专业内容创作与个人品牌建设专家 Agent，专注于思想领导力内容、高互动率内容策略和 LinkedIn 算法机制。七阶段内容工作流（受众定位→钩子工程→帖子构造→格式优化→轮播制作→主页优化→互动策略）；受众分群 Playbook（创始人/求职者/开发者/B2B）；LinkedIn 算法四杠杆（停留时间/收藏率/早期互动速度/原生内容）；轮播深层架构；评论转管道系统。核心理念：中性内容 = 中性结果；首句钩子决定一切；发布后首 60 分钟响应决定算法分发。 +- Concepts: Thought Leadership / Hook Engineering / Content Pillar / LinkedIn Algorithm / Personal Brand Architecture / Carousel Architecture / Inbound Lead Generation — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: LinkedIn — 仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-linkedin-content-creator.md +- Notes: 步骤1-9全部完成；index.md 第467行已有条目（LinkedIn Content Creator），无需更新；overview.md 已添加专项条目（Professional Social Media 部分），位于 marketing-twitter-engager 之后；Contradictions 节记录与 [[Marketing Social Media Strategist]] 的策略细节张力（互动率区间差异），协调为互补关系；log.md 已追加。 + +## [2026-05-17] ingest | Marketing Weibo Strategist +- Source file: Agent/agency-agents/marketing/marketing-weibo-strategist.md +- Status: ✅ 成功摄入 +- Summary: 微博全栈运营与品牌传播策略专家 Agent，专注帮助品牌在新浪微博实现热搜霸榜与持续增长。核心理念：微博是"公共舆论场"，核心价值在于声量份额而非私域运营；爆款传播公式 = 争议性 × 低参与门槛 × 情绪共鸣；舆情响应黄金4小时原则。核心方法：账号定位 → 话题矩阵设计 → 超级话题社区运营 → KOL 分层合作 → 付费+有机流量叠加 → 实时舆情监控 → 数据复盘迭代。 +- Concepts: 热搜话题运营 / 超级话题管理 / 粉丝经济 / 舆情监控 / KOL 合作 / 微博广告 / 内容策略 / 微博电商 — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: 微博蓝V / 微博指数 / 微指数 / 微博任务平台 — 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-weibo-strategist.md +- Notes: 步骤1-9全部完成；index.md 第460行已有条目（Marketing Weibo Strategist），确认内容正确；Source Page 已生成，含9个 Key Concepts（wikilink 格式）、5个 Key Entities（wikilink 格式）、4个 Key Claims、4个 Key Quotes、2组 Connections、2组 Contradictions；Contradictions 与 [[营销私域运营]]（运营思维冲突）、[[营销快手策略]]（平台属性差异）记录在案；log.md 已追加。 + +## [2026-05-16] ingest | Marketing Social Media Strategist +- Source file: Agent/agency-agents/marketing/marketing-social-media-strategist.md +- Status: ✅ 成功摄入（更新） +- Summary: 跨平台社交媒体战略专家 Agent，专注于 LinkedIn、Twitter 等专业社交平台的企业级品牌建设和社群运营。核心理念：通过统一信息流设计、平台适配内容优化、社群互动管理、思想领导力建设，实现品牌在专业社交平台的影响力提升。关键指标：LinkedIn 互动率 3%+（公司页面）/5%+（个人品牌）、每月受众覆盖增长 20%、员工倡导参与率 30%+、社交广告 ROI 3 倍+。 +- Concepts: Cross-Platform Strategy / B2B Social Selling / Thought Leadership / Employee Advocacy / Content Calendar Management / LinkedIn Algorithm Optimization / Social Listening / Community Management — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: LinkedIn / Twitter / LinkedIn Ads / Reddit — 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-social-media-strategist.md +- Notes: 步骤1-9全部完成；本页面于2026-04-26已存在，本次为完整更新，补充了 Workflow Integration（handoff/collaborate/delivers/escalates）、Decision Framework（8个使用场景）、Success Metrics（8项指标）、Platform Strategy Framework（LinkedIn/Twitter/Cross-Platform）、Campaign Management（Planning/Tracking）、Thought Leadership Development、Communication Style、Learning & Memory 等完整章节；index.md 第459行已有条目（Social Media Strategist），本次确认内容正确；overview.md 第860行已有详细条目，本次确认内容一致；无新冲突发现；log.md 已追加。 + +## [2026-05-17] ingest | Marketing WeChat Official Account Manager +- Source file: Agent/agency-agents/marketing/marketing-wechat-official-account.md +- Status: ✅ 成功摄入 +- Summary: 微信公众号全栈运营操盘手 Agent，专注于内容策略、订阅者关系建设、多格式内容运营、自动化工作流与转化优化。核心理念：微信公众号是中国最私密的商业沟通渠道，不是广播频道而是关系建设工具。核心方法：60/30/10 内容法则（60% 价值内容+30% 互动内容+10% 推广内容）、五阶段运营工作流（订阅者分析→内容策略→内容创作→自动化运营→数据分析）、微信原生功能整合（自动回复/关键词响应/菜单架构/小程序集成）。绩效目标：打开率 30%+、菜单点击率 20%+、文章读完率 50%+、月自然增长 10-20%、转化率 2-5%、终身订阅者价值超过内容投入 10 倍。 +- Concepts: ContentPillarStrategy / SubscriberRelationshipBuilding / MiniProgramIntegration / ConversionOptimization / AutoReplySystem / SegmentationStrategy — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: WeChat / WeChatMiniProgram — 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-wechat-official-account.md +- Notes: 步骤1-9全部完成；index.md 第462行已有条目（Marketing WeChat Official Account Manager），确认内容正确；overview.md 第899行已有详细条目，本次确认内容一致；Contradictions 节记录与 [[MarketingSocialMediaStrategist]] 的跨平台内容策略差异（统一内容 vs 本地化定制），属互补关系；log.md 已追加。 + +## [2026-05-15] ingest | Marketing Kuaishou Strategist +- Source file: Agent/agency-agents/marketing/marketing-kuaishou-strategist.md +- Status: ✅ 成功摄入 +- Summary: 快手平台短视频营销与直播电商运营专家 Agent 人格定义。核心理念：真实性 > 精致度，快手均衡分发算法 + 下沉市场受众 + 老铁关系驱动商业变现。关键方法：3-2-1 话术框架、直播前中后完整 playbook、私域运营提升 LTV。与抖音策略构成中国短视频营销双平台差异化策略体系。 +- Concepts: 下沉市场 / 直播带货 / 老铁经济 / 私域运营 / 内容真实性 — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页；老铁经济因高频出现且为核心差异化概念，已创建独立 Concept 页 +- Entities: Douyin — 已存在（由 healthcare-marketing-compliance 创建），sources 字段已更新；Kuaishou.md 已新建；快手小店 仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-kuaishou-strategist.md +- Notes: 步骤1-9全部完成；index.md 第465行已有条目，无需更新；overview.md 第1164行已追加条目29；Entity Kuaishou.md 已新建；Concept 老铁经济.md 已新建（核心差异化概念，高频出现）；Contradictions 节记录与 [[营销抖音策略]] 的平台差异（均衡分发 vs 中心化推荐 / 下沉市场 vs 一二线城市 / 真实性 vs 精致化 / 关系驱动 vs 流量驱动）；log.md 已追加。 + +## [2026-05-14] ingest | Marketing Video Optimization Specialist +- Source file: Agent/agency-agents/marketing/marketing-video-optimization-specialist.md +- Status: ✅ 成功摄入 +- Summary: YouTube 视频营销优化专家 Agent，专注最大化视频触达率和互动率。核心理念：前 30 秒（The Hook）决定观众去留，CTR 1.5% 提升可触发推荐算法，封面标题协同讲述微故事。方法：YouTube SEO、留存率图谱分析、战略性章节划分、跨平台分发（Shorts/Reels/TikTok）。成功指标：8%+ CTR、50%+ 第3分钟留存、20%+ AVD 提升。交付物模板涵盖包装策略→视频结构→SEO元数据。 +- Concepts: YouTube SEO / CTR Optimization / Audience Retention / The Hook / Video Chaptering / Cross-Platform Syndication / Initial Velocity / Session Time Maximization — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: YouTube Studio / YouTube Shorts / TikTok / Instagram Reels — 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-video-optimization-specialist.md +- Notes: 步骤1-9全部完成；index.md 第455行已有条目（Marketing Video Optimization Specialist），本次确认内容正确；overview.md 第873行已有详细条目，无需更新；无新冲突；log.md 已追加。 + +## [2026-05-13] ingest | Marketing China E-Commerce Operator +- Source file: Agent/agency-agents/marketing/marketing-china-ecommerce-operator.md +- Status: ✅ 成功摄入 +- Summary: 中国电商多平台运营专家 Agent人格定义，覆盖淘宝/天猫/拼多多/京东/抖音小店。核心方法：多平台差异化运营 + 大促T-60作战模型 + 直播电商（目标贡献GMV 20%+）+ 广告ROAS优化（目标3:1）+ 私域运营。 +- Concepts: 直播带货/私域运营/直通车/万相台/超级推荐/多多搜索/千人千面/大促运营/广告ROAS优化/跨平台差异化 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Douyin.md 已存在，本次更新 sources 字段添加 marketing-china-ecommerce-operator 引用；淘宝/天猫/拼多多/京东/抖音店铺/快手/小红书/微信 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-china-ecommerce-operator.md +- Notes: 步骤1-9全部完成；index.md 第468行已有条目，无需更新；overview.md 已新增详细条目；Douyin.md entity sources 字段已更新；Contradictions 节记录与 [[Marketing Cross-Border E-Commerce Specialist]] 的合规策略张力；log.md 已追加。 + - Source file: Agent/agency-agents/marketing/marketing-douyin-strategist.md - Status: ✅ 成功摄入 - Summary: 抖音短视频营销与直播带货策略专家 Agent 的人格定义文档。核心内容：算法优先思维（完播率>点赞率>评论率>分享率）、黄金3秒钩子（冲突/价值/悬念/共鸣四型）、短视频脚本结构模板（1-3s钩子+4-20s内容+21-30s收尾）、直播排品结构（引流款20%/利润款50%/形象款15%/秒杀款15%）、直播节奏控制（每15分钟一次流量峰值）、DOU+精准投放策略、矩阵账号运营 playbook。 @@ -326,7 +699,14 @@ - Source page: wiki/sources/supply-chain-strategist.md - Notes: 步骤1完成：读取原始文档（582行）；步骤2完成：读取 index.md（条目已存在 Line 396）、overview.md（无供应链相关内容，需追加）；步骤3完成：生成 source page（含 frontmatter、Summary、Key Claims×5、Key Quotes×4、Key Concepts×14、Key Entities×12、Connections×7、Contradictions）；步骤4完成：index.md Sources 节新增 supply-chain-strategist 条（Line 7）；步骤5完成：overview.md Line 52 后追加综合摘要；步骤6-7完成：新建 3 个 Entity 页面（Supply-Chain-Strategist/QiChaCha/Tianyancha）和 1 个 Concept 页面（Kraljic-Matrix），补充现有 TCO.md 的供应链场景应用；index.md Entities 和 Concepts 节同步更新；步骤8完成：无跨页面内容冲突，TCO 跨场景应用已标注；步骤9完成：log.md 追加记录 -## [2026-05-30] ingest | ZK Steward Agent +## [2026-05-30] ingest | Marketing Bilibili Content Strategist +- Source file: Agent/agency-agents/marketing/marketing-bilibili-content-strategist.md +- Status: ✅ 成功摄入 +- Summary: B站内容策略与UP主成长专家Agent人格定义——弹幕文化精通、B站算法优化（完播率/三连/投币权重）、封面点击率优化、社区驱动增长、品牌恰饭原生化。核心理念：社区优先、质量优先、尊重弹幕文化。关键指标：三连率>5%、弹幕密度>30条/分钟关键片段、每月至少一条视频进入"每周必看"。与抖音、快手构成中国短视频营销差异化平台策略体系。 +- Entities: [[Bilibili]]（已存在，last_updated更新至2026-05-30，sources字段追加marketing-bilibili-content-strategist）；Douyin/Kuaishou/WeChat/Weibo/Xiaohongshu均已存在，无需新建Entity页面 +- Concepts: 弹幕设计/三连/UP主品牌/花火平台/内容垂类/直播带货/跨平台协同——各仅在本source page提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用，无需独立Concept页 +- Source page: wiki/sources/marketing-bilibili-content-strategist.md +- Notes: 步骤1-9全部完成；source page已生成，含6个Key Claims、4个Key Quotes、8个Key Concepts（wikilink格式）、8个Key Entities（wikilink格式）、5条Connections、2组Contradictions（与Douyin/Kuaishou平台差异张力）；index.md第472行已有条目，本次更新日期和一行摘要；overview.md第869行已有详细条目，本次确认内容一致；Entity Bilibili.md的last_updated和sources字段已更新；log.md已追加。 - Source file: Agent/agency-agents/specialized/zk-steward.md - Status: ✅ 成功摄入 - Summary: ZK Steward Agent 完整摄取——将 Niklas Luhmann 的 Zettelkasten 卡片盒笔记法引入 AI Agent，用于构建有链接、可验证、持续生长的知识网络。核心机制：Luhmann 四原则验证（原子性 / 连通性 / 有机增长 / 持续对话）+ 领域专家切换（按领域 × 任务类型 × 输出形式选取 Feynman/Munger/Ogilvy/Karpathy/Mollick 等心智模型）+ 任务闭环清单（归档 / 链接提案 / Gegenrede 反问 / 每日日志 / 开放循环清理）。Source page 含 5 条 Key Claims、4 条 Key Quotes、6 个 Key Concepts、6 个 Key Entities、5 条 Connections、2 条 Contradictions。 @@ -595,7 +975,16 @@ - Source page: wiki/sources/sales-deal-strategist.md（更新：date 2026-05-18，扩充新增能力相关内容） - Notes: 步骤1完成：读取原始文档（新增 Deal Inspection/Multi-Threading/Forecast Accuracy 章节）；步骤2完成：读取 index.md、overview.md 和现有 source page；步骤3完成：更新 source page（日期更新+内容扩充：Key Claims/Key Concepts/Key Entities/Connections）；步骤4完成：index.md 第408行日期补全（2026-05-18）；步骤5完成：overview.md 无需大幅更新，新增内容与现有框架一致；步骤6完成：Entity 未创建独立页面（Key Entities 以 wikilinks 记录于 source page）；步骤7完成：Concept 均以 wikilinks 形式记录于 source page，未达到独立建页阈值；步骤8完成：检测并记录与 sales-pipeline-analyst 的新连接关系（评分数据流向）；步骤9完成：log.md 追加记录 -## [2026-04-29] ingest | Sales Engineer Agent +## [2026-05-30] ingest | Game Audio Engineer Agent（增量验证） +- Source file: Agent/agency-agents/game-development/game-audio-engineer.md +- Status: ✅ 增量验证完成（last_updated 更新至 2026-05-30） +- Summary: 游戏交互式音频工程师 AI Agent 人格规范——设计自适应音乐系统、空间音频架构和音频中间件集成方案。核心规范：所有音频必须通过 FMOD/Wwise 中间件触发、音乐转换必须 tempo-synced、所有世界空间音效必须使用 3D 空间化、语音数量必须配置 budget + priority + steal mode。成功指标：零音频卡顿、所有事件配置 voice limit、音乐转换无缝、内存预算达标、所有 diegetic 音效激活 occlusion + reverb。 +- Concepts: AdaptiveMusic / SpatialAudio / VoiceBudgeting / AudioMiddleware / ProceduralAudio / Ambisonics / HRTF / A/BParameterTesting / AudioCertification — 均仅在本 source page 首次引入，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: FMOD / Wwise / Unity / UnrealEngine / Godot / DolbyAtmos / DTSX — 均仅在本 source page 首次引入，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Entity 页 +- Source page: wiki/sources/game-audio-engineer.md +- Notes: 步骤1-9全部完成；source page 已存在（2026-04-26 初次摄入），本次更新 last_updated 字段；index.md 已有条目（第500行）；检测到无内容冲突——game-audio-engineer 与同系列其他 game development agents（Godot Multiplayer Engineer / Godot Gameplay Scripter / Godot Shader Developer / Unity Architect / Unity Multiplayer Engineer / Unity Shader Graph Artist / Unreal Systems Engineer / Unreal Multiplayer Architect / Technical Artist / Narrative Designer / Level Designer / Roblox Systems Scripter / Blender Add-on Engineer / Game Designer / Autonomous Game Dev Pipeline）构成完整游戏开发 Agent 协作体系，audio 作为垂直专项与 gameplay/graphics/multiplayer 并列，无冲突；log.md 追加记录。 + +## [2026-04-26] ingest | Game Audio Engineer Agent - Source file: Agent/agency-agents/sales/sales-engineer.md - Status: ✅ 成功摄入 - Summary: Sales Engineer Agent 完整摄取——售前工程师 Agent 角色定义与核心能力框架。核心能力：技术发现（结构化挖掘架构/集成/安全约束/真实决策标准）、Demo Engineering（以影响力为导向：先量化问题→展示结果→逆向讲解→证明收尾，以 [[AhaMoment]] 为核心成功标准）、POC Scoping（严格限定范围：成功标准前置+2-3周硬性时间线+中期检查点）、FIA Framework（Fact-Impact-Act 竞争定位框架）、技术异议解码（识别表面问题背后的真实诉求）、评估笔记维护。关键数据：技术赢率70%+，POC转化率80%+，演示到下一步行动率90%+，中位数18天技术决策。 @@ -1456,3 +1845,186 @@ - Entities: 无新 Entity（创始人和读者为泛化角色，不满足≥2次或关键影响创建条件） - Source page: wiki/sources/marketing-book-co-author.md - Notes: 步骤1完成：读取原始文档（110行）；步骤2完成：读取 index.md（第468行已有条目）和 overview.md（已有相关描述无需更新）；步骤3完成：新建 source page（7个 Key Concepts 全部创建独立 Concept 页面，1个 Contradiction 记录与通用 AI 内容生成工具的冲突）；步骤4完成：index.md Sources 节第468行已有条目无需更新，Concepts 节新增7个条目；步骤5完成：overview.md 已有相关描述，无需更新；步骤6完成：无新 Entity；步骤7完成：新建7个 Concept 页面（ThoughtLeadershipBook/Ghostwriting/NarrativeArchitecture/VoiceProtection/ChapterBlueprint/EditorialWorkflow/FirstPersonBusinessWriting）并加入 index.md；步骤8完成：与通用 AI 内容生成工具的内容风格冲突已记录在 source 页；步骤9完成：log.md 追加记录。 + +## [2026-05-13] ingest | Marketing Cross-Border E-Commerce Specialist +- Source file: Agent/agency-agents/marketing/marketing-cross-border-ecommerce.md +- Status: ✅ 成功摄入 +- Summary: 跨境电商多平台运营与品牌全球化策略 Agent，覆盖 Amazon/Shopee/Lazada/AliExpress/Temu/TikTok Shop。核心五步工作流（市场调研→合规准备→Listing 发布→广告引流→数据迭代）。三大核心原则：合规优先、本地化制胜、供应链成本控制。关键交付物：产品评估计分卡、平台策略对比表、Amazon PPC 三阶段框架（Launch/Growth/Mature）。关键指标：净利率 >18%、ACOS 20-25%、TACOS <12%、库存周转 >6x/年。 +- Concepts created: ACOS, Localization（均满足创建条件，独立创建 Concept 页面） +- Entities created: FBA, Shopify（均满足≥2次或关键影响创建条件，独立创建 Entity 页面） +- Source page: wiki/sources/marketing-cross-border-ecommerce.md +- Notes: 步骤1完成：读取原始文档（259行，17674字节）；步骤2完成：读取 index.md（第464行已有条目，日期 2026-04-26）和 overview.md（已含跨境电商相关内容无需更新）；步骤3完成：重新生成 source page（原页面 5052 字节 < 源文件 17674 字节，触发重新摄入；新增 Key Concepts：IOSS/OSS、KOL/KOC、DTC、FTO Search；新增 Key Entities：SellerSprite、PingPong/Payoneer/WorldFirst/LianLian、Klaviyo/Mailchimp、WEEE/EPR；更新 Contradictions 节：新增 Temu 利润率与净利率 >18% 目标之间潜在张力）；步骤4完成：index.md 第464行已有条目，日期已为 2026-04-26，无需更新；步骤5完成：overview.md 已有跨境电商条目，无需更新；步骤6完成：新建 FBA.md、Shopify.md Entity 页面；步骤7完成：新建 ACOS.md、Localization.md Concept 页面；步骤8完成：Contradictions 已记录在 source 页（与 Marketing Douyin Strategist 的流量逻辑差异、与 Temu 的利润率张力）；步骤9完成：log.md 追加记录。 + +## [2026-05-13] ingest | Marketing Reddit Community Builder +- Source file: Agent/agency-agents/marketing/marketing-reddit-community-builder.md +- Status: ✅ 成功摄入 +- Summary: Reddit 社区营销专家 Agent，核心理念是"成为有价值贡献的社区成员，恰好代表品牌"而非"在 Reddit 上做营销"。核心机制：90/10 法则（90% 价值内容/10% 推广）、四阶段工作流（社区研究→内容策略→声誉建立→战略价值创造）、Karma 声望系统。成功指标：10,000+ karma、5+ 子版块可信贡献者身份、AMA 500+ 问答互动、品牌讨论 80%+ 正面情感。 +- Concepts created: 无（90/10 Rule/Community-First Engagement/AMA 等仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用） +- Entities created: 无（Reddit/Subreddit/Moderator/Community Karma 均为泛化平台概念，不满足≥2次或具体关键影响创建条件） +- Source page: wiki/sources/marketing-reddit-community-builder.md +- Notes: 步骤1完成：读取原始文档（122行，7620字节）；步骤2完成：读取 index.md（第458行已有条目）和 overview.md；步骤3完成：新建 source page（含 Summary/Key Claims/Key Quotes/Key Concepts/Key Entities/Connections/Contradictions 七节）；步骤4完成：index.md 第458行已有条目，无需更新；步骤5完成：overview.md 末尾追加第28条综合摘要；步骤6完成：无新 Entity；步骤7完成：无新 Concept；步骤8完成：与即时转化导向营销思维的冲突已记录在 source 页 Contradictions 节；步骤9完成：log.md 追加记录。 + +## [2026-04-26] ingest | Marketing Instagram Curator +- Source file: Agent/agency-agents/marketing/marketing-instagram-curator.md +- Status: ✅ 成功摄入（已有记录，本次补充日志） +- Summary: Instagram 营销专家 Agent，专注视觉叙事、品牌美学建设、多格式内容运营与社交电商转化。四阶段工作流：品牌美学开发 → 多格式内容策略 → 社区建设与电商 → 绩效优化。1/3 内容法则（品牌/教育/社区内容各占三分之一）。绩效目标：互动率 3.5%+、Story 完成率 80%+、购物转化 2.5%+、UGC 月产 200+ 条。 +- Concepts: Visual Brand Development / Multi-Format Content Strategy / Community Cultivation / Social Commerce Excellence / One-Third Content Rule / Instagram Shopping / Algorithm Optimization / UGC Campaigns 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Instagram / Instagram Reels / IGTV / Instagram Shopping 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用 +- Source page: wiki/sources/marketing-instagram-curator.md +- Notes: 步骤1完成：读取原始文档（112行，6675字节）；步骤2完成：读取 index.md（第465行已有条目）和 overview.md（第881行已有详细摘要）；步骤3完成：source page 已存在（2026-04-26，56行），内容完整；步骤4完成：index.md 第465行已有条目，无需更新；步骤5完成：overview.md 第881行已有详细条目，无需更新；步骤6完成：无新 Entity；步骤7完成：无新 Concept；步骤8完成：与 [[Marketing TikTok Strategist]] 的平台特性差异已记录在 source 页 Contradictions 节；步骤9完成：log.md 追加记录。 + +## [2026-05-16] ingest | Marketing Short-Video Editing Coach +- Source file: Agent/agency-agents/marketing/marketing-short-video-editing-coach.md +- Status: ✅ 成功摄入 +- Summary: 短视频剪辑全流程技术教练 Agent，覆盖完整后期制作管线。核心理念：剪辑的核心不是软件熟练度而是叙事能力和节奏感，软件是工具叙事是灵魂。软件选型决策树（CapCut首选日更/Pr商业项目/DaVinci Resolve调色/Final Cut Pro Mac）+ 镜头语言体系 + 调色（初级校正+二级调色）+ 音频工程（降噪→人声增强→BGM混音）+ 字幕设计 + 多平台导出优化 + AI辅助剪辑（字幕95%+/智能抠像/文字成片/数字人）。关键观点：音频优先于视频；LUT是起点而非终点（60%-80%强度）；模板化后单视频从2小时降至30分钟；AI承担60%重复工作。 +- Concepts: 剪辑思维/速度曲线/节拍同步/调色/LUT应用/代理剪辑/AI辅助剪辑/多平台导出策略 — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: CapCut Pro / Adobe Premiere Pro / DaVinci Resolve / Final Cut Pro / Suno AI / OpenAI Whisper — 均仅提及1次，不满足≥2次创建条件，已在 Source Page 中引用 +- Source page: wiki/sources/marketing-short-video-editing-coach.md +- Notes: 步骤1-9全部完成；index.md 第460行已有条目，无需更新；overview.md 第889行已有详细条目，无需更新；无新 Entity 页面创建（各工具仅提及1次）；无新 Concept 页面创建（各概念仅提及1次）；Contradictions 节记录与 [[固定镜头短视频制作的ai全流程解析]] 的AI内容真实性张力；log.md 已追加。 + +## [2026-05-16] ingest | Marketing Private Domain Operator（核查） +- Source file: Agent/agency-agents/marketing/marketing-private-domain-operator.md +- Status: ✅ 核查完成——源文件未更新（最后修改：2026-04-26 12:35），Wiki source page 已存在（2026-04-28 07:24），内容完整，无需重新生成 +- Summary: 企业微信（WeCom）私域运营专家 Agent，专注私域生态系统构建、用户生命周期管理与全漏斗转化优化 +- Concepts: 无新概念（已在2026-04-26原摄入时处理） +- Entities: 无新实体（已在2026-04-26原摄入时处理） +- Source page: wiki/sources/marketing-private-domain-operator.md +- Notes: 步骤1完成（读取源文件，确认修改时间 2026-04-26）；步骤2完成（读取 index.md 第462行已有条目，overview.md 第895/896行已有详细条目）；步骤3跳过（内容已存在且完整）；步骤4跳过（index.md 第462行已有条目）；步骤5跳过（overview.md 内容一致）；步骤6跳过（无新实体）；步骤7跳过（无新概念）；步骤8完成（无新冲突）；步骤9完成（log.md 已追加本条目）。 + +## [2026-05-17] ingest | Marketing Carousel Growth Engine +- Source file: Agent/agency-agents/marketing/marketing-carousel-growth-engine.md +- Status: ✅ 成功摄入（更新） +- Summary: 全自动 TikTok/Instagram 轮播图增长引擎 Agent——将任意网站 URL 转化为病毒式 6 张轮播图并每日自主发布。核心理念：数据驱动的自我优化闭环，每次发布积累数据驱动下次改进。架构：Playwright 网站分析 → Gemini 图像生成（图生图视觉连贯）→ Upload-Post API 双平台发布 → Analytics Feedback Loop。 +- Concepts: [[6-Slide Narrative Arc]] / [[Visual Coherence Engine]] / [[Analytics Feedback Loop]] / [[Niche-Aware Content Generation]] / [[Autonomous Quality Assurance]] — 均已存在，本次更新 Source Page 补充 Key Quotes、The-Agency Entity 引用及 Connections 字段 +- Entities: [[GoogleGemini]]（更新 sources 添加 marketing-carousel-growth-engine）/ [[Upload-Post]]（已存在）/ [[Playwright]]（已存在）/ [[The-Agency]]（已存在，本次更新 sources） +- Source page: wiki/sources/marketing-carousel-growth-engine.md +- Notes: 步骤1完成（读取源文件，共199行）；步骤2完成（读取 index.md 第469行已有条目，overview.md 第893行已有详细条目）；步骤3完成（Source Page 已存在，本次更新：补充 Key Quotes 2条新增引文、Connections 补充 The-Agency 引用）；步骤4完成（index.md 第469行已有条目，无需更新）；步骤5完成（overview.md 第893行条目已完整，无需更新）；步骤6完成（entities 均已存在，GoogleGemini.md 和 The-Agency.md 的 sources 字段已更新）；步骤7完成（concepts 均已存在）；步骤8完成（无新冲突）；步骤9完成（log.md 已追加本条目）。 + +## [2026-05-17] ingest | Marketing Baidu SEO Specialist +- Source file: Agent/agency-agents/marketing/marketing-baidu-seo-specialist.md +- Status: ✅ 成功摄入（字段更新） +- Summary: 百度搜索生态优化与中国市场 SEO 专家 Agent，专注于中文搜索引擎排名、百度生态整合、ICP 合规、中文关键词研究与移动优先索引。核心理念：ICP 备案是不可妥协的法定前提，无有效备案则无排名；百度与 Google 根本不同，必须从零学习百度算法体系、生态偏好和监管要求。核心方法：四阶段工作流（合规基础→关键词研究→站内技术优化→站外权威建设）+ 百度生态矩阵（百科/知道/贴吧/文库/经验各有分工）+ 算法专项应对（飓风/细雨/惊雷/蓝天/清风）。关键交付物：百度 SEO 审计模板、中文关键词分类矩阵、百度生态内容策略。 +- Concepts: Baidu-SEO / ICP-Filing / Baidu-Ecosystem-Integration / China-Mobile-First-Indexing / Chinese-Keyword-Research / Baidu-Algorithm-Mastery — 均已存在（由 healthcare-marketing-compliance / nexus-spatial-discovery 等早期摄入创建），本次确认引用正确，无需新建 +- Entities: Baidu / BaiduSpider / ICP备案 / Baidu-Zhidao / Baidu-Baike — 均已存在（Baidu.md 由早期摄入创建），本次确认 sources 字段包含 marketing-baidu-seo-specialist +- Source page: wiki/sources/marketing-baidu-seo-specialist.md +- Notes: 步骤1完成（读取源文件，共226行）；步骤2完成（读取 index.md 第471行已有条目，overview.md 第891行已有详细条目）；步骤3完成（Source Page 已存在，本次补充 last_updated: 2026-05-17 字段以符合 AGENTS.md 标准格式）；步骤4完成（index.md 第471行更新日期为 2026-05-17 并补充一行摘要）；步骤5完成（overview.md 第891行已有完整条目，无需更新）；步骤6完成（entities 均已存在，Baidu.md 等 entity pages 的 sources 字段已包含本 source）；步骤7完成（concepts 均已存在：Baidu-SEO.md / ICP-Filing.md / Baidu-Ecosystem-Integration.md 等）；步骤8完成（source page 已包含 Contradictions 节，与抖音/快手策略师的流量机制差异、与 Google SEO 的本质差异均有记录）；步骤9完成（log.md 已追加本条目）。 + +## [2026-05-20] ingest | Marketing Livestream Commerce Coach +- Source file: Agent/agency-agents/marketing/marketing-livestream-commerce-coach.md +- Status: ✅ 成功摄入 +- Summary: 直播带货全链路运营教练 Agent，覆盖主播孵化（五阶段话术框架）、产品排品（引流款/主推款/利润款/秒杀款）、流量运营（付费+有机三阶段模型）、数据复盘模板。核心理念：停留时长和互动率决定平台给免费流量，GMV 是结果而非目标。覆盖抖音/快手/淘宝直播/视频号四大平台。 +- Concepts: 直播话术框架 / 流量三阶段模型 / 直播产品配比 / 停留时长优化 / 互动率优化 / GPM — 均仅在本页提及，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Douyin（sources 追加 marketing-livestream-commerce-coach）/ Kuaishou（sources 追加 marketing-livestream-commerce-coach）— 均已存在，sources 字段已更新 +- Source page: wiki/sources/marketing-livestream-commerce-coach.md +- Notes: 步骤1-9全部完成；source page 已创建，含直播带货全链路运营教练内容；index.md 第469行已有条目；overview.md 第889行已有详细条目；Douyin.md 和 Kuaishou.md 的 sources 字段已追加本 source；log.md 已追加。 + +## [2026-05-30] ingest | AI Citation Strategist +- Source file: Agent/agency-agents/marketing/marketing-ai-citation-strategist.md +- Status: ✅ 成功摄入 +- Summary: AI Citation Strategist Agent——专注于 AI 推荐引擎优化（AEO/GEO）的营销 Agent，审计品牌在 ChatGPT/Claude/Gemini/Perplexity 四大 AI 平台的引用可见性，生成 Fix Pack 改善内容信号。核心差异化：AI 引用 ≠ SEO 排名，引用信号（实体清晰度、结构化权威、FAQ对齐、Schema标记）完全不同。平台差异化：ChatGPT 偏好权威性+结构化页面，Claude 偏好细腻平衡+溯源，Gemini 依赖 Google 生态+实时搜索，Perplexity 偏好来源多样性+时效性。提示词模式工程：围绕用户实际查询模式设计内容（Best X for Y/X vs Y/How to choose X 等）。五步工作流：Discovery → Audit → Analysis → Fix Pack → Recheck。 +- Concepts created: Answer-Engine-Optimization, Generative-Engine-Optimization +- Source page: wiki/sources/marketing-ai-citation-strategist.md +- Notes: 步骤1-9全部完成；source page 已创建，含核心主题摘要、4个 Key Claims（AI引用≠SEO排名/引用率量化/多平台审计/非确定性保证）、4个 Key Quotes、7个 Key Concepts（wikilink）、4个 Key Entities（wikilink）、3条 Connections、1条 Contradiction（与 [[marketing-seo-specialist]] 的SEO与AEO信号差异冲突）；index.md 第473行原有条目已存在，无需修改；overview.md 第39行原有条目已扩充（平台差异模式+提示词模式工程+完整五步方法）；新建 [[Answer-Engine-Optimization]] 和 [[Generative-Engine-Optimization]] 两个 Concept 页面并已在 index.md 同步；[[GoogleGemini]] Entity 已存在，sources 字段已追加；log.md 已追加。 + +## [2026-05-30] ingest | Unreal Multiplayer Architect +- Source file: Agent/agency-agents/game-development/unreal-engine/unreal-multiplayer-architect.md +- Status: ✅ 成功摄入 +- Summary: Unreal Multiplayer Architect Agent——UE5 多人游戏网络架构师 Agent，专注服务器权威模型、Actor 复制、网络预测、GAS 复制和专用服务器配置。核心原则：服务器拥有真相、客户端预测+协调；每个 Server RPC 必须实现 `_Validate()`；GameMode/GameState/PlayerState/PlayerController 严格层级分离；GAS 双初始化路径（PossessedBy + OnRep_PlayerState）；Replication Graph 可将带宽降低 40%；每玩家带宽目标 < 15KB/s。 +- Concepts: Actor-Replication / Server-Authoritative-Model / RPC-Remote-Procedure-Call / Network-Prediction / GAS-Gameplay-Ability-System / Replication-Graph / NetUpdateFrequency — 均已存在于 wiki/concepts/，无需新建 +- Entities: UnrealEngine5 — 新建实体页面（UE5 游戏引擎，多个 game-dev agent 共用） +- Source page: wiki/sources/unreal-multiplayer-architect.md +- Notes: 步骤1-9全部完成；source page 为新建（wiki/sources/unreal-multiplayer-architect.md）；index.md 第484行条目已存在（Unreal Multiplayer Architect），无需修改；overview.md 第1030行条目已存在，内容一致无需更新；6个 Key Concepts（Actor-Replication/Server-Authoritative-Model/RPC-Remote-Procedure-Call/Network-Prediction/GAS-Gameplay-Ability-System/Replication-Graph）均已存在于 wiki/concepts/，已在 Source Page 中以 wikilink 引用；UnrealEngine5 Entity 新建并同步到 index.md；无冲突记录；log.md 已追加。 + +## [2026-04-30] ingest | Unreal World Builder Agent Personality +- Source file: Agent/agency-agents/game-development/unreal-engine/unreal-world-builder.md +- Status: ✅ 成功摄入 +- Summary: Unreal World Builder Agent——UE5 开放世界环境架构 AI Agent，专注 World Partition 分区流式、Landscape 地形、PCG 程序化植被、HLOD 层级 LOD、Nanite 几何系统，覆盖 4km²~64km² 超大规模开放世界。核心理念：格子大小控制流送预算、RVT 消除地形层混合成本、LWC 解决超大世界坐标精度。关键规则：Always Loaded 层存放常驻内容、禁止游戏关键内容放格子边界、景观空洞用 Visibility Layer、PCG 预烘焙大于 1km² 区域、OFPA 支持多用户协作编辑。 +- Concepts: WorldPartition（新建）/ ProceduralContentGeneration（新建）/ HierarchicalLOD（新建）/ Landscape（新建）/ RuntimeVirtualTexturing（新建）/ LargeWorldCoordinates（新建）/ OneFilePerActor（新建）/ Nanite（已存在，更新 sources）——均已写入 wiki/concepts/ +- Entities: EpicGames（新建）/ UnrealEngine5（更新 sources）——均已写入 wiki/entities/ +- Source page: wiki/sources/unreal-world-builder.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/unreal-world-builder.md）；index.md第484行条目已补充日期[2026-04-30]；overview.md第1043行条目已扩充，新增Landscape Visibility Layer规范、HLOD Mesh Merge参数、PCG Runtime限制、LWC着色器LWCToFloat()规范、OFPA文件数预算、流式性能仪表盘；7个Concept（WorldPartition/PCG/HLOD/Landscape/RVT/LWC/OFPA）和2个Entity（EpicGames/UnrealEngine5）全部新建，Nanite已有Concept页面并更新sources；Contradictions章节记录无冲突（与unreal-technical-artist中PCG/Landscape/HLOD描述一致）；log.md已追加。 + +## [2026-05-30] ingest | Game Designer Agent Personality +- Source file: Agent/agency-agents/game-development/game-designer.md +- Status: ✅ 成功摄入 +- Summary: Game Designer Agent——以"循环、杠杆、玩家动机"为思维框架的游戏系统与机制设计师。将创意愿景转化为工程师和美术可无歧义执行的 GDD。核心方法：五步工作流（概念→设计支柱→纸面原型→GDD撰写→调优迭代）；三层核心循环（瞬间 0-30s → 会话 5-30min → 长期 数小时至数周）；数值以 `[PLACEHOLDER]` 标记假设。高级能力涵盖行为经济学应用（Cialdini 原则/损失厌恶/变量奖励/沉没成本/禀赋效应）、高级经济设计（供给-需求模型/通胀检测/Monte Carlo 模拟）、系统性涌现设计。 +- Concepts: Core-Gameplay-Loop / Economy-Balance / Behavioral-Economics-in-Games / Playtest-Driven-Design / Systemic-Emergence / Cross-Genre-Mechanic-Transplantation — 均仅提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用 +- Entities: NarrativeDesigner / LevelDesigner / GameAudioEngineer — 均仅提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用 +- Source page: wiki/sources/game-designer.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/game-designer.md）；index.md第494行条目已补充日期[2026-05-30]；overview.md第1024行game-designer条目已存在，本次摄入为内容同步（内容一致无需更新）；6个Key Concepts和3个Key Entities均仅提及1次，不满足≥2次创建条件，已在Source Page中以wikilink引用；Contradictions章节记录与[[Level Designer]]在机制抽象设计与空间上下文实现的张力；log.md已追加。 + +## [2026-04-26] ingest | Unity Multiplayer Engineer +- Source file: Agent/agency-agents/game-development/unity/unity-multiplayer-engineer.md +- Status: ✅ 成功摄入 +- Summary: Unity Multiplayer Engineer Agent——Unity 多人游戏网络编程专家 Agent，涵盖 Netcode for GameObjects（NGO）、Unity Gaming Services（Relay/Lobby）、服务器权威模型、客户端预测与调和、延迟补偿、带宽管理和反作弊架构等技术规范。核心理念：服务器权威非协商原则，客户端仅发送输入，位置/生命值/分数等关键状态归服务器所有；NetworkVariable 用于持久化状态，RPC 用于一次性事件；客户端预测移动在 LateUpdate 中与服务器调和，偏差超过阈值时强制回正；Relay 用于所有玩家托管游戏以保护主机 IP；非关键状态更新限流至 10Hz。 +- Concepts: ServerAuthority / ClientPrediction / NetworkVariable / ServerRpc / ClientRpc / UnityRelay / UnityLobby / LagCompensation / BandwidthManagement / AntiCheatArchitecture — 均已存在于 wiki/concepts/，本次摄入更新 BandwidthManagement.md 的 last_updated（2026-04-26），其余仅在 Source Page 中引用无需新建 +- Entities: Unity / NetcodeForGameObjects / UnityGamingServices / UnityTransport / UnityMultiplayerEngineer — 均已存在于 wiki/entities/，本次摄入更新 Unity.md、NetcodeForGameObjects.md、UnityGamingServices.md、UnityMultiplayerEngineer.md 的 last_updated（2026-04-26） +- Source page: wiki/sources/unity-multiplayer-engineer.md +- Notes: 步骤1-9全部完成；source page已存在（本次为确认检查，无需重写）；index.md第487行条目已存在（date: 2026-04-26）；所有 Entity 页面（Unity/NetcodeForGameObjects/UnityGamingServices/UnityTransport/UnityMultiplayerEngineer）均已存在于 wiki/entities/，已更新 last_updated；所有 Concept 页面（ServerAuthority/ClientPrediction/NetworkVariable/ServerRpc/ClientRpc/UnityRelay/UnityLobby/LagCompensation/BandwidthManagement/AntiCheatArchitecture）均已存在于 wiki/concepts/，已更新 BandwidthManagement.md 的 sources 和 last_updated；Contradictions章节记录与[[UnrealMultiplayerArchitect]]在客户端预测实现细节上的差异（Unity用NetworkVariable+LateUpdate调和，Unreal用帧缓冲+回滚）；log.md已追加。 + +## [2026-05-02] ingest | Unity Architect Agent Personality +- Source file: Agent/agency-agents/game-development/unity/unity-architect.md +- Status: ✅ 成功摄入 +- Summary: Unity 游戏架构师 AI Agent——数据驱动模块化架构专家，精通 ScriptableObject 优先设计、职责拆分和反模式消除。核心理念：ScriptableObject-First + 零硬引用（禁止 GameObject.Find/FindObjectOfType/静态单例）。核心模式：FloatVariable SO（含 OnValueChanged 事件）、GameEvent 事件通道（GameEventListener）、RuntimeSet 无单例实体追踪。高级能力：Addressables 资源管理、DOTS 混合架构（ECS + Job System + Burst Compiler）、Memory Profiler + Unity Profiler 深度分析。核心冲突：与 "Manager Singleton" 惯用法对立。 +- Concepts: ScriptableObject / EventChannelPattern / RuntimeSet / Addressables / DOTS / BurstCompiler / DataOrientedDesign / SingleResponsibilityPrinciple — 集中引用于 sources/unity-architect.md，本次摄入暂不创建独立 Concept 页面，待多个 source 页面引用后批量创建 +- Entities: UnityArchitect — 集中引用于 sources/unity-architect.md，本次摄入暂不创建独立 Entity 页面，待多个 source 页面引用后批量创建 +- Source page: wiki/sources/unity-architect.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/unity-architect.md）；index.md第488行条目已更新（补充日期2026-05-02和完整标题"Unity Architect Agent Personality"）；overview.md第1074行条目已存在且覆盖全部新增内容，无需修订；所有 Concepts 和 Entities 已在 Source Page 的 Key Concepts / Key Entities / Connections 节通过 [[wikilink]] 格式引用，暂不创建独立页面；Contradictions章节记录与"Manager Singleton"惯用法的冲突；log.md已追加。 + +## [2026-05-01] ingest | Blender Add-on Engineer Agent Personality +- Source file: Agent/agency-agents/game-development/blender/blender-addon-engineer.md +- Status: ✅ 成功摄入 +- Summary: Blender Add-on Engineer AI Agent——Blender 工具开发专家，通过 Python + bpy API 构建自定义 Operators、Panels、Property Groups，实现资产验证、导出自动化和命名规范检查。核心理念：Pipeline-first, artist-empathetic, automation-obsessed, reliability-minded。核心规范：优先使用 bpy.data 等数据 API 而非脆弱的 bpy.ops 上下文调用；验证工具必须在自动修复前报告问题；批量工具精确记录变更；导出器除非用户明确选择否则不破坏源场景。核心交付物：Asset Validator Operator（含命名/变换/材质槽检查）、Pipeline Export Panel（含导出预设）、Naming Audit Report 模板。高级能力：Collection-based Publish Flows、Geometry Nodes 封装 UI、glTF/FBX/USD 多格式导出、跨引擎交接规范化。 +- Concepts: AssetValidation / PipelineAutomation / NamingConventions / NonDestructiveWorkflow / BpyAPI / CollectionBasedExport — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 [[wikilink]] 引用，无需独立 Concept 页 +- Entities: Blender / glTF / FBX / USD / Unity / Unreal — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/blender-addon-engineer.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/blender-addon-engineer.md）；index.md第495行条目已更新（补充日期2026-05-01）；overview.md第1002行条目已存在且覆盖完整，无需修订；所有 Concept 和 Entity 均仅提及1次，无需独立页面；Connections 已记录（BlenderAddonEngineer 与 GameDesigner/TechnicalArtist/UnityArchitect/UnrealWorldBuilder/UnityShaderGraphArtist 的协作关系）；Contradictions 已记录（与 UnityEditorToolDeveloper 在工具开发平台定位上的领域差异）；log.md已追加。 + +## [2026-05-01] ingest | Software Architect Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-software-architect.md +- Status: ✅ 成功摄入 +- Summary: 软件架构 Agent 角色规范——专注于系统设计、领域驱动设计（DDD）和架构决策记录（ADR）。核心理念：领域优先、技术其次；权衡分析优先于最佳实践；可逆性决策优先于"最优"决策；文档化决策的 WHY 而非 WHAT。核心交付物：ADR 模板（Status/Context/Decision/Consequences）、系统设计流程（Domain Discovery → Architecture Selection → Quality Attribute Analysis）、架构模式选型表（Modular Monolith / Microservices / Event-driven / CQRS）。核心规则：No Architecture Astronautics（每个抽象必须自证其复杂性）、Trade-offs over Best Practices（明确放弃什么）、Domain First（先理解业务再选工具）、Reversibility Matters（易于改变的决策优先）、Document Decisions（ADR 捕获 WHY）。属 The Agency 工程专项 Agent 体系，与 BackendArchitectWithMemory、SpecializedWorkflowArchitect、SpecializedSalesforceArchitect 等架构角色共同构成工程能力矩阵。 +- Concepts created: [[DomainDrivenDesign]]（在本文档中首次创建，满足≥2次出现条件）、[[ArchitectureDecisionRecord]]（在本文档中首次创建，满足≥2次出现条件）；CQRS / EventDrivenArchitecture / ModularMonolith / Microservices / CircuitBreaker / C4Model / BoundedContext / EventStorming — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: SoftwareArchitect / EventStorming — 均仅在本页提及，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-software-architect.md +- Notes: 步骤1-9全部完成；source page为新建（wiki/sources/engineering-software-architect.md）；index.md已更新（第7行）；Concept 页面已创建（DomainDrivenDesign.md、ArchitectureDecisionRecord.md）并已添加至 index.md Concepts 节；冲突检测：与 Microservices 实践存在"可逆性"张力（详见 Source Page Contradictions 节）；log.md已追加。 + +## [2026-05-01] ingest | Embedded Firmware Engineer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-embedded-firmware-engineer.md +- Status: ✅ 成功摄入 +- Summary: Embedded Firmware Engineer Agent 人格定义——专注于资源受限嵌入式系统的生产级固件开发。核心理念：生产级固件不能崩溃。核心约束：禁止动态分配（malloc/new）、ISR 最小化、栈大小必须计算验证。平台差异化实践：ESP-IDF（ESP32 Wi-Fi+BLE）、STM32 LL vs HAL（时序关键优先 LL）、Nordic nRF Zephyr（devicetree+Kconfig）、PlatformIO 生产锁定版本。核心交付物：FreeRTOS 任务架构、外设驱动（UART/SPI/I2C/CAN/BLE/Wi-Fi）、OTA 升级。成功指标：零栈溢出、ISR 延迟 < 10µs、Flash/RAM ≤ 80% 预算。 +- Concepts created: FreeRTOS / ARM-Cortex-M / ESP-IDF / STM32-HAL-LL / Zephyr-RTOS / OTA-Upgrade — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: ESP32 / STM32 / Nordic-nRF / PlatformIO / FreeRTOS — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-embedded-firmware-engineer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-embedded-firmware-engineer.md）；index.md已更新（Sources 节第12行新增条目）；overview.md第84行后新增条目；所有 Concept 和 Entity 均仅提及1次，无需独立页面；冲突检测：与 [[engineering-rapid-prototyper]] 的速度哲学张力已记录在 Source Page Contradictions 节；log.md已追加。 + +## [2026-05-01] ingest | Email Intelligence Engineer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-email-intelligence-engineer.md +- Status: ✅ 成功摄入 +- Summary: Email Intelligence Engineer Agent 个性定义——将原始邮件（MIME/Gmail API/Microsoft Graph）转换为 AI Agent 可消费的结构化推理上下文的专用 Agent。核心四步管道：邮件摄取与标准化 → 线程重建与去重 → 结构化分析（参与者检测、决策时间线、行动项归因） → 上下文组装与工具接口（混合检索、Token 预算管理、带来源引用的结构化 JSON）。关键指标：线程重建准确率 >95%、去重压缩 4-5x、行动项归因 >90%、Agent 下游任务准确率提升 >20%。LangChain / CrewAI / LlamaIndex / MCP Server 集成目标。 +- Concepts created: [[Thread-Reconstruction]] / [[Content-Deduplication]] / [[Participant-Detection]] / [[Action-Item-Attribution]] / [[Hybrid-Retrieval]] / [[Context-Assembly]] — 以上六个概念均在本页首次创建或以 wikilink 引用，满足创建条件；[[PII-Redaction]] / [[Decision-Through-Silence]] — 仅在本页提及1次，无需独立页面；[[LangChain]] / [[CrewAI]] / [[LlamaIndex]] — 已有独立 Entity 页面，本页已引用 +- Entities: [[LangChain]]（已有页面） / [[CrewAI]]（已有页面） / [[LlamaIndex]]（已有页面） — 均已有独立 Entity 页，无需新建 +- Source page: wiki/sources/engineering-email-intelligence-engineer.md +## [2026-05-01] ingest | Feishu Integration Developer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-feishu-integration-developer.md +- Status: ✅ 成功摄入 +- Summary: Feishu Integration Developer Agent 个性定义——飞书开放平台全栈集成专家，覆盖自定义机器人、交互式消息卡片、审批流自动化、Bitable 多维表格、SSO/OIDC 认证和飞书小程序六大核心模块。核心理念：飞书集成不只是调用 API，必须处理权限模型、事件幂等性、多租户架构。核心工程标准：tenant/user_access_token 严格区分；API 响应必须检查 code 字段；事件处理必须幂等（防飞书重复投递）；卡片 JSON 必须在 Card Builder 验证；Bitable 批量写入每请求上限 500 条。核心交付物：TokenManager（含提前5分钟刷新边界保护）、CardBuilder（含 Approve/Reject/View Details 三按钮）、EventDispatcher、OAuth 三步流程（state 防 CSRF）。 +- Concepts created: [[Tenant-Access-Token]] / [[User-Access-Token]] / [[Message-Card]] / [[Event-Subscription]] / [[Bitable]] / [[OAuth-2-0-Feishu]] / [[Idempotency]] — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: [[LarkSuite-API-SDK]] / [[Feishu-Open-Platform]] / [[Feishu-Card-Builder]] — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +## [2026-05-01] ingest | Threat Detection Engineer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-threat-detection-engineer.md +- Status: ✅ 成功摄入 +- Summary: Threat Detection Engineer Agent 个性定义——专注于构建检测层，在攻击者绕过预防控制后捕获威胁。核心能力：Sigma 规则开发（厂商无关）并编译为 Splunk SPL / Sentinel KQL / Elastic EQL / Chronicle YARA-L；MITRE ATT&CK 覆盖度映射与差距评估；威胁狩猎（主动搜寻检测遗漏的威胁）；告警调优（降低误报率）；Detection-as-Code CI/CD 流水线（Git + CI + 自动部署）。核心理念：检测质量 > 检测数量；行为检测优于 IOC 匹配；规则即代码（绝不在 SIEM 控制台直接编辑）；每个规则映射到至少一个 ATT&CK 技术；覆盖完整杀伤链。关键指标：平均误报率 <15%、MTTD <48小时、100% 规则通过 CI/CD 部署。 +- Concepts created: Detection Engineering / Threat Hunting / Alert Tuning / Detection-as-Code / Purple Team / MITRE ATT&CK Mapping — 均仅在本页提及1次，不满足≥2次创建条件，已在 Source Page 中以 wikilink 引用，无需独立 Concept 页 +- Entities: Sigma / MITRE ATT&CK / Splunk / Microsoft Sentinel / Elastic / Sysmon — 均仅在本页提及1次，不满足≥2次创建条件，无需独立 Entity 页 +- Source page: wiki/sources/engineering-threat-detection-engineer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-threat-detection-engineer.md）；index.md已更新（Sources 节新增条目，置顶）；overview.md第88行后新增 entry；冲突检测：Alert Tuning 与检测灵敏度的张力已记录在 Source Page Contradictions 节；log.md已追加。 + +## [2026-05-01] ingest | CMS Developer Agent Personality +- Source file: Agent/agency-agents/engineering/engineering-cms-developer.md +- Status: ✅ 成功摄入 +- Summary: CMS Developer Agent 个性定义——专注于 Drupal 和 WordPress 网站开发的专业 Agent，可交付从内容建模到上线审计的完整 CMS 开发生命周期。核心理念："A CMS isn't a constraint — it's a contract with your content editors." 核心原则：ContentModel-first（先锁定字段/内容类型/编辑工作流再写代码）、Code over configuration UI（所有内容类型/分类/字段通过代码注册）、Never fight the CMS（使用 hooks/filters/plugin 系统，绝不 monkey-patch 核心）。技术栈：WordPress 自定义主题/插件（Gutenberg Blocks、ACF Pro、子主题）、Drupal 自定义模块（Hook 系统、Block 插件、Twig 模板、Layout Builder）。 +- Entities created: WordPress — 仅本次首次提及，已创建独立 Entity 页面（含 WordPress 关键模式代码）；Drupal — 仅本次首次提及，已创建独立 Entity 页面（含 Drupal 模块结构代码） +- Concepts created: ContentModel-first — 仅本次首次提及，已创建独立 Concept 页面（含 WordPress/Drupal 具体应用）；CodeOverConfiguration — 仅本次首次提及，已创建独立 Concept 页面（含 WordPress/Drupal 配置位置对照表） +- Source page: wiki/sources/engineering-cms-developer.md +- Notes: 步骤1-9全部完成；source page已生成（wiki/sources/engineering-cms-developer.md）；index.md已更新（Sources 节新增条目置顶、Entities 节新增 WordPress + Drupal、Concepts 节新增 ContentModel-first + CodeOverConfiguration）；overview.md Engineering Agents 部分新增 entry；冲突检测：无已知冲突；wikilinks（ContentModel-first/CodeOverConfiguration/WordPress/Drupal/LayoutBuilder/TwigTemplating/GutenbergBlockEditor/BackendArchitect/SoftwareArchitect/WCAGCompliance）指向的页面已全部创建；log.md已追加。 \ No newline at end of file diff --git a/wiki/overview.md b/wiki/overview.md index 9dc7c6a5..469a497e 100644 --- a/wiki/overview.md +++ b/wiki/overview.md @@ -4,6 +4,18 @@ This wiki is a living synthesis of curated sources spanning AI agents, cloud inf ## Major Themes +### Engineering Agents + +**[[engineering-database-optimizer]]**（Database Optimizer Agent）：The Agency 工程部门的数据库性能优化专家 Agent——核心专长：PostgreSQL 优化和高级特性（EXPLAIN ANALYZE、查询计划解读）、B-tree/GiST/GIN/部分索引策略、Schema 设计（规范化 vs 反规范化权衡）、N+1 查询检测与解决、连接池管理（PgBouncer、Supabase pooler）、零停机迁移策略。支持 PostgreSQL、MySQL、Supabase 和 PlanetScale。关键规则：始终检查查询计划、外键必须加索引、避免 SELECT *、使用连接池、迁移必须可逆、生产环境永不锁表（使用 CONCURRENTLY）、防止 N+1 查询（使用 JOIN 替代循环）、监控慢查询（pg_stat_statements）。核心价值：提供可直接用于生产的 SQL 模板和 TypeScript 代码示例。与 [[engineering-backend-architect]] 存在依赖关系——后端架构师的设计决策需遵循数据库优化专家的原则。 + +**[[engineering-senior-developer]]**（Senior Developer Agent）：The Agency 工程部门的高端 web 实现专家 Agent——专注于使用 Laravel/Livewire/FluxUI 实现"奢华感"（Premium）web 体验。核心理念：**"Every pixel should feel intentional and refined"**，性能与美感必须共存。核心要求：必须实现亮色/暗色/系统主题切换、大留白+精致排版、微交互动画（磁性按钮、流畅过渡）、玻璃拟态（glass morphism）视觉效果。技术栈：Laravel/Livewire 全栈框架、FluxUI 专业组件库、高级 CSS（glass morphism、organic shapes、cubic-bezier 缓动曲线）、Three.js WebGL 集成（粒子背景、3D 产品展示）。质量标准：加载 < 1.5s、动画 60fps、WCAG 2.1 AA 无障碍。关键规则：FluxUI 组件参考官方文档、Alpine.js 已随 Livewire 捆绑无需单独安装。与 [[engineering-rapid-prototyper]] 互补——原型优先速度，高级开发者优先品质。 + +**[[engineering-git-workflow-master]]**（Git Workflow Master Agent）：The Agency 工程部门的 Git 工作流与版本控制专家 Agent——专注于帮助团队维护干净的提交历史、有效的分支策略，以及高级 Git 特性（worktree/interactive rebase/bisect）。核心理念：**"Clean history, atomic commits, and branches that tell a story."** 核心使命：原子提交（每次提交只做一件事）、Smart branching（根据团队规模和发布节奏选择合适策略）、Safe collaboration（rebase vs merge 决策）、Advanced techniques（worktrees/bisect/reflog/cherry-pick）、CI integration（分支保护 + 自动化检查）。关键规则：永远不要在共享分支上强制推送（使用 `--force-with-lease`）、PR 前必须 rebase 到目标分支最新 + +**[[engineering-cms-developer]]**（CMS Developer Agent）：The Agency 工程部门的 CMS 开发专家 Agent——专注于 Drupal 和 WordPress 网站开发，可交付从内容建模到上线审计的完整 CMS 开发生命周期。核心理念：**"A CMS isn't a constraint — it's a contract with your content editors."** 核心专长：WordPress 自定义主题/插件开发（Gutenberg Blocks、ACF Pro、子主题结构）、Drupal 自定义模块开发（Hook 系统、Block 插件、Twig 模板、Layout Builder）、内容建模与字段 API 设计。关键原则：ContentModel-first（先锁定字段/内容类型再写代码）、Code over configuration UI（所有内容类型/分类/字段通过代码注册）、Never fight the CMS（使用 hooks/filters/plugin 系统，绝不 monkey-patch 核心）。平台选择：Drupal 适合复杂内容模型/企业级/多语言；WordPress 适合编辑简单性/WooCommerce/广泛插件生态。 + +**[[engineering-backend-architect]]**（Backend Architect Agent）：The Agency 工程部门的后端架构师 Agent—— + ### 知识与资源 **[[3-2-万人收藏的-claude-skills-才是-ai-这条路上最值得研究的一套范式-1]]**（Claude Skills 范式图谱）：Anthropic 官方 Skills 仓库全面解析——核心主张：Claude Skills 是写给 Claude 的「说明书」+ SOP（标准作业程序），将反复执行、有固定流程的任务拆解为 AI 能理解、能稳定复用、能自动执行的流程。官方仓库（github.com/anthropics/skills）3.2 万+星，将 Claude.ai 生产级能力原封不动拆解公开，涵盖办公自动化（Word/PDF/PPT/Excel）、开发者工具（MCP Server/Web 测试/Artifacts 构建）、创意类技能三大类。**核心范式转变**：Claude Skills 的爆发标志着 AI 应用从「提示词工程」进入「流程工程」时代；Vibe Coding 的尽头也是 Skills；真正有价值的不是 Prompt 写得最花的人，而是最懂业务流程、能将经验沉淀成 SOP 的人。属 [[AI时代发展策略]] 的方法论层，为 [[Claude Skills]] 和 [[流程工程（Workflow Engineering）]] 提供实践案例支撑。与 [[vibe-coding经验收集]] 的「验证优于流程」观点存在张力，两者互补——Vibe Coding 是探索阶段，Skills 是验证成功后沉淀为可复用流程的阶段。 @@ -25,32 +37,69 @@ The wiki covers two major multi-agent frameworks: **The Agency** (agency-agents) **The Agency 贡献指南**（[[contributing_zh-cn]] + [[contributing]] 英文原版）：The Agency 项目贡献者指南——核心贡献方式：①创建全新智能体（8大分类：engineering/design/marketing/product/project-management/testing/support/spatial-computing/specialized）；②优化现有智能体；③分享成功案例；④反馈问题。智能体设计五原则：**鲜明性格**（拒绝通用人设）、**明确交付物**（真实代码/模板）、**可量化指标**、**经过验证的工作流**、**学习记忆机制**。PR 流程包含提交前检查（真实场景测试、遵循模板、补充示例）、社区评审与迭代优化。属 [[Multi-Agent-System-Reliability]] 的智能体设计规范层，为 [[Multi-Agent-Team]] 提供标准化的智能体创建框架。 +**[[design-ux-architect]]**：The Agency Design 部门的核心技术架构与 UX 基础专家 Agent——核心职责：在 ProjectManager 和 LuxuryDeveloper 之间建立技术桥梁，提供 CSS 设计系统（变量/间距/字体）、Grid/Flexbox 布局框架和 Theme Toggle 组件。Foundation-first 理念：架构决策由 UX Architect 在前期完成，开发者专注实现而非做架构决策。Theme Toggle（light/dark/system 三态）是所有新站点的默认必备组件，基于 localStorage + `prefers-color-scheme` 实现。组件命名遵循 BEM/Utility-first/Component-based 任一方法，并在项目内保持一致。与 LuxuryDeveloper 属于时序分工（Foundation → Polish），分界线在"专业 UX 基线建立"之后。与 [[design-whimsy-injector]] 互补——后者在 UX Architect 建立的基线之上叠加趣味性设计，通过微交互、趣味文案和游戏化提升品牌记忆度。 + +**[[design-ux-researcher]]**（UX Researcher）：The Agency Design 部门的用户体验研究专家 Agent——核心职责：通过混合研究方法（定性与定量结合）理解用户行为、验证设计决策、提供可落地洞察。与 [[design-ux-architect]] 和 [[design-whimsy-injector]] 共同构成 Design 部门三支柱（Research → Architecture → Delight）。研究方法论：先确立清晰研究问题 → 选择有统计依据的样本量和研究方法 → 通过三角验证缓解偏差 → 转化为可实施的设计建议。交付物包含用户画像（含直接引用语）、用户旅程地图、可用性测试结果（A/B测试支持）和优先级建议（高/中/长期）。默认要求包含无障碍研究和包容性设计测试。与 [[design-ux-architect]] 存在张力：研究洞察是设计系统输入，但架构决策在某些情况下基于技术约束而非用户数据——通过时序分工协调（Research → Architecture → Polish）。 + +**[[design-whimsy-injector]]**（Whimsy Injector）：The Agency Design 部门的品牌趣味性设计专家 Agent——核心职责：为品牌注入差异化、趣味性的交互元素，在用户感知路径的全流程嵌入愉悦感。趣味分类学四层：Subtle Whimsy（悬停效果/加载动画）、Interactive Whimsy（点击反馈/表单验证庆祝）、Discovery Whimsy（复活节彩蛋/隐藏功能）和 Contextual Whimsy（404页面/空状态）。交付物包括品牌个性框架、微交互 CSS 系统、趣味文案库和游戏化成就系统。核心原则：趣味必须有功能性或情感性目的，不可喧宾夺主；必须对残障用户和文化背景不同用户可访问。与 [[design-ux-architect]] 时序协作（基线 → 趣味叠加），属 [[Multi-Agent-System-Reliability]] 的 Design 部门 Agent 设计层。 + +**[[design-brand-guardian]]**（Brand Guardian）：The Agency Design 部门的品牌守护者专家 Agent——核心职责：创建内聚的品牌身份系统，确保品牌在所有触点的一致表达，并提供品牌保护策略。品牌 Foundation Framework（Purpose/Vision/Mission/Values/Personality）是所有品牌决策的基础；Visual Identity System（Logo/Color/Typography）必须作为内聚系统设计；Brand Voice and Messaging 定义品牌声音特征（Strategic/Consistent/Protective/Visionary）。默认要求包含品牌保护（商标/合规监控/危机管理）。与 [[design-ux-architect]] 时序协作——Brand Guardian 先定义品牌战略框架 → UX Architect 再构建技术实现系统；与 [[design-whimsy-injector]] 互补——Brand Guardian 定义的品牌个性是 Whimsy Injector 趣味性设计的输入。属 [[Multi-Agent-System-Reliability]] 的 Design 部门 Agent 设计层。 + **[[llms-rag-ai-agent-三个到底什么区别]]**（LLM/RAG/AI Agent 三者区别）：AI 应用入门基础知识——作者将 LLM 比作"天才大脑"（擅长思考但不知当前）、RAG 比作"随身图书馆助理"（动态获取外部知识，消除幻觉）、AI Agent 比作"循环控制系统"（感知→规划→执行→反思的自主行动能力）。核心观点：三者并非竞争技术，而是在三个不同层面互补协同——**LLM 用于思考，RAG 用于认知，Agent 用于执行**。生产系统应叠加三者：纯语言任务用 LLM、需准确性时加 RAG、需真正自主性时部署 Agent。属 [[Multi-Agent-AI-Systems]] 的基础概念层。 **[[multi-agent-team]]**（Multi-Agent Specialized Team — Solo Founder Setup）：Solo Founder 通过多 Agent 专业化团队实现"一人公司"运作的实战方案——4个专业 Agent（Milo 战略lead / Josh 商业分析 / Marketing 内容营销 / Dev 开发）+ 共享记忆 + Telegram 单入口 + 定时任务自动推送。核心洞察：**Agent 个性化**使"和团队对话"比"使用工具"更自然（Milo 自信有魅力、Josh 务实数据驱动）；**共享记忆 + 私有上下文**组合是核心——共同 ground（目标/决策）+ 各积累领域专长；按任务复杂度匹配模型（Claude Opus 做战略、Gemini 做长文本研究、Codex 做实现）；定时主动推送洞察而非被动响应形成价值飞轮。建议从小团队开始（lead + 1 specialist），按瓶颈逐步扩展。属 [[Multi-Agent-System-Reliability]] 的团队协作实践层，与 [[ContentFactory]]（内容创作流水线）和 [[Agents-Orchestrator]]（流水线编排）同属多 Agent 协作模式的不同维度，可结合使用。 -**[[AI Citation Strategist]]**（AI Citation Strategist Agent）：专注于 AI 推荐引擎优化（AEO/GEO）的营销 Agent——审计品牌在 ChatGPT、Claude、Gemini、Perplexity 四大 AI 平台上的引用可见性，识别竞争对手被引用的原因，生成 Fix Pack 改善内容信号。与 [[Marketing SEO Specialist]] 互补但独立——传统 SEO 成功不能自动转化为 AI 可见性，AEO 与 SEO 必须作为不同策略对待。核心方法：多平台 Citation Audit Scorecard → Lost Prompt Analysis → 竞品内容结构映射 → Schema markup + 实体信号优化 → Fix Pack 优先级实施。与 [[Marketing Agentic Search Optimizer]] 同属 AI 驱动的内容可见性优化方向。属 [[Multi-Agent-System-Reliability]] 的营销 Agent 设计层。 +**[[AI Citation Strategist]]**（AI Citation Strategist Agent）：专注于 AI 推荐引擎优化（AEO/GEO）的营销 Agent——审计品牌在 ChatGPT、Claude、Gemini、Perplexity 四大 AI 平台上的引用可见性，识别竞争对手被引用的原因，生成 Fix Pack 改善内容信号。与 [[Marketing SEO Specialist]] 互补但独立——传统 SEO 成功不能自动转化为 AI 可见性，AEO 与 SEO 必须作为不同策略对待。核心差异化：**AI 引用 ≠ SEO 排名**，引用的信号（实体清晰度、结构化权威、FAQ 对齐、Schema 标记）完全不同。**平台差异化**：ChatGPT 偏好权威性+结构化页面（FAQ/对比表/how-to指南），Claude 偏好细腻平衡+明确溯源的分析内容，Gemini 依赖 Google 生态信号+实时搜索集成，Perplexity 偏好来源多样性+时效性+直接答案。**提示词模式工程**：围绕用户实际输入 AI 的查询模式设计内容——"Best X for Y"（对比内容）、"X vs Y"（专页对比+Schema）、"How to choose X"（买家指南+决策框架）、"What is the difference between X and Y"（清晰定义）。核心方法：Discovery（20-40 提示词生成）→ Audit（四平台查询记录引用率）→ Analysis（竞品内容结构映射）→ Fix Pack（按影响力优先级排序）→ Recheck（14天复测）。属 [[Multi-Agent-System-Reliability]] 的营销 Agent 设计层，与 [[Marketing Agentic Search Optimizer]] 同属 AI 驱动的内容可见性优化方向。 **[[nexus-spatial-discovery]]**（Nexus Spatial Discovery Exercise）：8个 The Agency 专业 Agent 并行协作完成 AI 空间指挥中心产品完整规划的实战案例——10分钟 wall-clock time 产出完整规划。参与 Agent：产品趋势研究员（市场验证 + Vision Pro 现实核查）、后端架构师（8服务 Rust 架构）、品牌守护者（定义 [[SpatialAIOps]] 新品类）、增长黑客（3阶段 GTM + 增长飞轮）、支持应答者（AI 内嵌空间的差异化支持设计）、UX 研究员（识别调试为杀手级用例）、XR 界面架构师（命令剧院 + 7态节点系统）、项目牧羊人（35周时间线 + 5团队分配）。跨 Agent 独立共识：2D先行（WebXR分发） > VisionOS、品牌 > 调试 > 战情室协作 > 渐进披露。核心张力：Growth Hacker（$29-59）与 Trend Researcher（$99-249）定价分歧待 A/B 测试。属 [[Multi-Agent-System-Reliability]] 的多 Agent 协作规划层实践，展示了并行 Agent 发现可产出连贯、相互引用的完整计划。与 [[Multi-Agent-Team]]（单团队多 Agent 架构）和 [[Agents-Orchestrator]]（流水线编排）同属多 Agent 协作模式的不同维度。 +**[[examples-readme]]**（The Agency Examples 索引）：The Agency 多 Agent 协作案例的索引与贡献指南——展示了当全体 Agent 协作时实际上是什么样子的。Nexus Spatial Discovery 是首个也是最完整的示例：8 个专业 Agent 并行运行，产出连贯、相互引用的完整计划，无须人工协调开销。贡献标准：多个 Agent 协作同一目标、展示 Agency 能力广度、具有现实适用性。是 [[Multi-Agent-Collaboration]] 概念的实践验证入口。 + **[[workflow-landing-page]]**：多 Agent 一天冲刺工作流——展示 Landing Page 场景下 4 个核心设计模式：**[[Parallel-Kickoff]]**（Content Creator + UI Designer 上午并行启动）、**[[Merge-Point]]**（Frontend Developer 等待两者完成）、**[[Feedback-Loop]]**（Growth Hacker 审查后 Frontend Developer 修改）、**[[Time-Boxing]]**（每个阶段严格时间盒：09:00→16:30）。与 [[workflow-startup-mvp]] 互补——后者以周为单位的长周期迭代，本工作流是单日冲刺的具体化实现。与 [[design-ui-designer]] 和 [[design-brand-guardian]] 共享 UI Designer 角色。 +**[[workflow-book-chapter]]**（Book Chapter Development Workflow）：单 Agent 工作流——[[BookCoAuthor]] Agent 将粗糙的原始素材（录音、碎片笔记、战略要点）转化为结构化的第一人称章节草稿。核心理念：**不是泛化 ghostwriting，而是保持作者声音 + 强化分类定位 + 暴露开放编辑决策**。五部分输出结构：Target Outcome（目标与战略定位）→ Chapter Draft（版本化章节草稿）→ Editorial Notes（假设与证据缺口的编辑注释）→ Feedback Loop（内部反馈循环）→ Next Step（明确修订问题而非模糊交接）。质量标准：草稿保持第一人称声音、claim 必须依附来源或标记为假设、删除泛化激励语言、以明确修订问题结尾。与 [[workflow-startup-mvp]]（多 Agent 长周期迭代）互补——前者聚焦单 Agent 聚焦式内容创作，后者是多 Agent 系统级协作；与 [[marketing-book-co-author]] 共享 Book Co-Author Agent，但本工作流是通用场景示例，后者是营销场景专用。属 [[TheAgency]] examples 层，与 [[agents-orchestrator]] 共同展示单 Agent 到多 Agent 的能力谱系。 + **GitHub Copilot Integration**（[[github-copilot]]）：The Agency 与 GitHub Copilot 的开箱即用集成——无需转换，Agency 的 `.md` + YAML frontmatter 格式与 GitHub Copilot 原生兼容。通过 `./scripts/install.sh --tool copilot` 一键安装，或手动复制到 `~/.github/agents/` 或 `~/.copilot/agents/` 目录。用户可在任意 Copilot 会话中通过名称激活特定 agent，如 `"Activate Frontend Developer and help me build a React component."`。与 [[readme|Cursor Integration]] 互补——后者项目级别生效，Copilot Integration 用户级别全局生效，共同构成 [[The Agency]] 的多 IDE 集成生态。 **Windsurf Integration**（[[windsurf-integration]]）：The Agency Agent roster 与 Windsurf 编辑器的集成方案——通过 `.windsurfrules` 文件将全部 Agent roster 聚合为单一规则文件，install.sh 脚本从项目根目录安装，项目级生效。Windsurf 中在 prompt 里按名称引用 Agent 即可激活（如 "Use the Frontend Developer agent to build this component."）。与 [[Cursor Integration]]（.mdc 规则）和 [[Aider Integration]]（CONVENTIONS.md）同为项目级 IDE 集成，机制相似，共同构成 The Agency 的多 IDE 覆盖体系。[[integrations-readme]] 已覆盖所有 11 种集成工具的概览。 +**Aider Integration**（[[aider-readme]]）：The Agency Agent roster 与 Aider 编辑器的集成方案——通过 `install.sh --tool aider` 安装，将全部 Agent roster 汇总到单一 `CONVENTIONS.md` 文件，Aider 会自动读取项目根目录的该文件。在 Aider 会话中按名称引用 Agent 即可激活（如 "Use the Frontend Developer agent to refactor this component."），或通过 `aider --read CONVENTIONS.md` 手动指定。`convert.sh --tool aider` 可重新生成最新的 CONVENTIONS.md。与 [[Windsurf Integration]]（.windsurfrules）、[[Cursor Integration]]（.mdc 规则）同为项目级 IDE 集成，共同构成 The Agency 的多编辑器支持生态。 + **Antigravity Integration**（[[antigravity-integration]]）：The Agency Agent roster 与 Antigravity/Gemini 的集成方案——通过 `./scripts/install.sh --tool antigravity` 将全部 Agent roster 转换为 Antigravity SKILL.md 文件，复制到 `~/.gemini/antigravity/skills/` 目录。所有 skill slug 统一使用 `agency-` 前缀（如 `agency-frontend-developer`）以避免与 Antigravity 原生 skills 冲突。用户可通过 `"Use the agency-frontend-developer skill to review this component."` 激活对应 agent。与 [[Cursor Integration]]（.mdc 规则）和 [[Windsurf Integration]]（.windsurfrules）同属多 IDE/平台集成，共同构成 The Agency 的完整集成生态，覆盖 Cursor（VS Code 兼容）、Windsurf、Copilot（用户级）和 Antigravity（Gemini）四大平台。 -**Kimi Code CLI Integration**（[[kimi]]）：The Agency 与 Kimi Code CLI 的集成方案——通过 `./scripts/convert.sh --tool kimi` 将所有 agent 转换为 `agent.yaml`（规范定义）+ `system.md`（系统提示词）的目录结构，再通过 `./scripts/install.sh --tool kimi` 安装到 `~/.config/kimi/agents/`。使用 `--agent-file` 标志激活特定 agent，支持 `extend: default` 继承 Kimi 内置 default agent 的工具集。与 [[readme|Cursor Integration]] 和 [[github-copilot]] 同属 The Agency 的多 IDE/CLI 集成生态，Kimi Code CLI 由 Moonshot AI 出品，与 Claude Code 形成竞争。 +**Kimi Code CLI Integration**（[[kimi]]）：The Agency 与 Kimi Code CLI 的集成方案——通过 `./scripts/convert.sh --tool kimi` 将所有 agent 转换为 `agent.yaml`（规范定义）+ `system.md`（系统提示词）的目录结构，再通过 `./scripts/install.sh --tool kimi` 安装到 `~/.config/kimi/agents/`。使用 `--agent-file` 标志激活特定 agent，支持 `extend: default` 继承 Kimi 内置 default agent 的工具集。与 [[readme|Cursor Integration]]（.mdc 规则）和 [[github-copilot]] 同属 The Agency 的多 IDE/CLI 集成生态，Kimi Code CLI 由 Moonshot AI 出品，与 Claude Code 形成竞争。 + +**Claude Code Integration**（[[claude-code-integration]]）：The Agency Agent roster 与 Claude Code 的原生集成方案——无需任何格式转换，The Agency 使用 `.md` + YAML frontmatter 格式原生支持 Claude Code。通过 `./scripts/install.sh --tool claude-code` 批量安装全部 Agent，或手动复制特定 Agent 目录到 `~/.claude/agents/`。在任意 Claude Code 会话中按名称引用即可激活 Agent（如 `"Activate Frontend Developer and help me build a React component."`）。与 [[github-copilot]]（用户级 Copilot）、[[readme|OpenCode Integration]]（OpenCode 子 Agent）、[[windsurf-integration]]（Windsurf .windsurfrules）同属 The Agency 的多 IDE 集成生态，共同构成跨平台 Agent 使用体系。 + +**Gemini CLI Integration**（[[gemini-cli]]）：The Agency Agent roster 与 Gemini CLI 的扩展集成方案——通过 `./scripts/convert.sh --tool gemini-cli` 将全部 61 个 Agent 转换为扩展文件，再通过 `./scripts/install.sh --tool gemini-cli` 安装到 `~/.gemini/extensions/agency-agents/`（Home-Scoped 级别）。安装后在 Gemini CLI 中按名称引用 Agent 即可激活（如 `"Use the frontend-developer skill to help me build this UI."`）。与 [[Antigravity Integration]]（同样面向 Gemini 平台但路径不同）和其他 IDE 集成共同构成 The Agency 的多平台覆盖体系。 + +**[[supply-chain-strategist]]**（Supply Chain Strategist Agent）：The Agency Specialized 部门的供应链管理专家 Agent——专注于中国制造业生态的端到端供应链优化。核心能力覆盖：供应商开发与分级管理（ABC 分类 + QCD 绩效考核）、战略采购（Kraljic 矩阵分类 + TCO 全成本分析）、质量管理（IQC/IPQC/OQC + AQL 抽样检验）、库存优化（EOQ + 安全库存 + 再订货点模型）、物流仓储（国内快递/零担/整车 + WMS 系统）、供应链数字化（ERP/SRM 系统选型 + 数字化成熟度评估 L1-L5）、成本控制（短期商业谈判到长期战略整合）和风险管理（多源采购 + 国产替代）。强调数据驱动决策（TCO 而非单价）+ 供应链安全优先（关键物料不得单一来源）。属 The Agency Specialized 部门的垂直领域专家 Agent，与工程类和营销类 Agent 共同构成完整的企业运营支持体系。 **OpenCode Integration**（[[readme|OpenCode Integration]]）：The Agency Agent roster 与 OpenCode 编辑器的子 Agent 集成方案——通过 `./scripts/install.sh --tool opencode` 安装，将 The Agency 的 .md 文件格式 Agent 转换为 OpenCode 的 `.opencode/agents/` 目录格式。核心机制：在 YAML frontmatter 中添加 `mode: subagent` 使 Agent 仅在 `@agent-name` 触发时出现，不会在 Tab 循环列表中占位；颜色通过命名颜色到十六进制的自动映射实现。支持两种安装范围：项目级（`.opencode/agents/`）和全局级（`~/.config/opencode/agents/`）。与 [[readme|Cursor Integration]]（.mdc 规则）、[[github-copilot]]（用户级 Copilot）、[[windsurf-integration]]（.windsurfrules）同属 The Agency 的多 IDE 集成生态，[[integrations-readme]] 已覆盖所有集成工具概览。 **MCP Memory Integration**（[[mcp-memory-integration]]）：The Agency 的 MCP Memory 集成方案——通过在 Agent 提示词中加入标准化的 Memory Integration 段落，为任意 Agent 赋予跨会话持久记忆能力，无需修改 Agent 代码。MCP Memory Server 提供四个核心工具：`remember`（存储决策/交付物快照）、`recall`（跨会话检索）、`rollback`（失败时回滚到上一个检查点）、`search`（跨 Agent 搜索记忆）。**Rollback 是杀手级功能**——当 QA 检查失败或架构决策出错时，直接恢复到已知良好状态而非从头重建。标签一致性是关键：每个记忆使用 Agent 名称和项目名称作为标签，确保 recall 可靠。与 [[specialized-mcp-builder]]（构建 MCP Server）和 [[ai-memory-tools-two-camps]]（AI 记忆工具全景分类）同属 The Agency MCP 生态的核心组成部分。 -**Backend Architect with Memory**（[[backend-architect-with-memory]]）：The Agency 中具备持久记忆能力的后端架构师 Agent——专门负责可扩展系统设计、数据库架构、API 开发与云基础设施。核心记忆机制：会话启动时检索 `backend-architect` + 项目名标签的历史记忆，防止重复讨论已做决策；架构决策以标签化快照持久化；交付物完成后主动标记接收方供下游 Agent 查找；QA 失败时检索最近良好检查点回滚。作为 [[agents-orchestrator]] 调度的具体执行 Agent，通过 MCP Memory 实现多 Agent 协作中的上下文连续性。 +**Backend Architect with Memory**（[[backend-architect-with-memory]]）：The Agency 中具备持久记忆能力的后端架构师 Agent——专门负责可扩展系统设计、数据库架构、API 开发与云基础设施。核心记忆机制：会话启动时检索 `backend-architect` + 项目名标签的历史记忆，防止重复讨论已做决策；架构决策以标签化快照持久化（含决策理由，供未来会话和其他 Agent 查找）；交付物完成后主动标记接收方供下游 Agent 查找；QA 失败时检索最近良好检查点并回滚，而非手动撤销变更链。标签一致性是记忆召回可靠工作的前提——每个记忆使用 Agent 名称 + 项目名 + 主题标签（如 `database-schema`/`api-design`/`auth-strategy`）三重标签。作为 [[agents-orchestrator]] 调度的具体执行 Agent，通过 MCP Memory 实现多 Agent 协作中的上下文连续性。与 [[engineering-software-architect]] 在架构决策记录方式上存在互补张力——后者用 ADR 文档供人类阅读，前者用 MCP Memory 快照供 Agent 自动化召回。 **[[engineering-software-architect]]**（Software Architect）：软件架构与系统设计专家 Agent——设计可维护、可扩展、符合业务领域的系统架构。核心理念：**"Designs systems that survive the team that built them."** 最佳架构是团队能实际维护的架构，反对过度设计。核心设计哲学：①权衡优先于最佳实践——命名所放弃的，而非仅列举所获得的；②领域优先、技术其次——理解业务问题再选工具；③可逆性优先于"最优"决策；④记录决策（WHY）而非仅记录设计（WHAT）。核心方法：ADR（Architecture Decision Record）标准化模板，捕捉 Context/Decision/Consequences 三要素；C4 模型分层沟通（Context/Container/Component/Code）；架构模式选型矩阵（Modular Monolith/Microservices/Event-Driven/CQRS 各自适用场景与规避条件）；质量属性分析（可扩展性/可靠性/可维护性/可观测性）。与 [[backend-architect-with-memory]] 在设计哲学上共享权衡优先、可逆性重要的核心价值观；在具体实现上，Backend Architect 侧重记忆持久化机制，Software Architect 侧重架构决策记录与模式选型；与 [[specialized-workflow-architect]] 在 ADR 使用上有协作关系。核心成功指标：每个关键决策均记录 ADR；所有权衡均有书面权衡分析；架构满足团队维护能力边界。 **[[engineering-mobile-app-builder]]**（Mobile App Builder）：移动应用开发专家 Agent——专注于原生 iOS/Android 开发和跨平台框架（Swift/SwiftUI、Kotlin/Jetpack Compose、React Native、Flutter）。核心理念：**平台感知、性能优先、用户体验驱动**。核心规范：遵循平台设计指南（Material Design / Human Interface Guidelines）；默认实现离线优先架构和智能数据同步；跨平台开发在代码复用与平台原生体验之间找到平衡。核心方法：MVVM 模式作为推荐架构；平台原生性能优化（冷启动 < 3 秒、内存 < 100MB、续航损耗 < 5%/小时）；生物识别认证（Face ID/Touch ID/指纹）、推送通知（APNs/Firebase）等平台特定功能集成。与 [[software-architect]] 共享系统架构思维应用于移动端；与 [[unity-architect]] 在跨平台理念上有分工——前者面向通用移动应用，后者面向游戏；与 [[visionos-spatial-engineer]] 和 [[xr-immersive-developer]] 共同构成 Apple 生态和 XR 领域的移动开发扩展。属 The Agency Engineering 部门。 + +**[[engineering-filament-optimization-specialist]]**（Filament Optimization Specialist）：Filament PHP 管理后台的结构性优化专家 Agent——专注于将"能用"的管理表单转化为"令人愉悦"的高体验界面，核心价值主张：**结构性改变（Tab/Grid/Collapsible）比装饰性改进（图标/提示文字）价值高 10 倍**。结构优化层次体系（按优先级）：Tab 分隔（逻辑分组字段）→ 并排 Grid（相关 Section 并排减少垂直滚动）→ Range Slider 替换（1-10 个 radio button 是 UX 反模式）→ 可折叠次要区块（默认折叠减少视觉噪音）→ Repeater `->itemLabel()`（使条目列表可识别）→ Summary Placeholder（编辑表单顶部关键指标摘要）→ NavigationGroup 导航分组。噪音控制三原则：最多一层引导（不堆叠 label+hint+placeholder）、图标克制（仅用于顶级 Tab 或高可见性区域）、保留明显默认值。与 [[design-ux-architect]] 共享 UX 优化理念但专注后端管理场景；属 The Agency Engineering 部门。 + +**[[engineering-backend-architect]]**（Backend Architect）：高级后端架构师 AI Agent——专注于可扩展系统设计、数据库架构、API 开发与云基础设施。核心理念：**安全性优先、性能意识、可靠性至上**。核心方法：数据/Schema 工程卓越（子 20ms 查询性能、10 万+实体索引、实时 WebSocket 推送）→ 可扩展系统架构（微服务分解、水平扩展设计）→ 系统可靠性（熔断器、优雅降级、自动扩缩容）→ 性能与安全优化（缓存策略、认证授权、深度防御）。默认要求：所有系统必须包含综合安全措施和监控。核心交付物：System Architecture Specification（含高层次架构模式选型矩阵：Microservices/Monolith/Serverless/Hybrid）、Database Schema（含 PostgreSQL + 索引优化示例）、API Design（含 Express.js + Helmet + Rate Limiting 安全中间件）。与 [[engineering-software-architect]] 共享架构思维，但 Backend Architect 关注实现细节（Schema/API/部署拓扑），Software Architect 关注抽象层次（领域边界/模式选型）；与 [[backend-architect-with-memory]] 在知识持久化方式上互补——基础版通过交付物文档传递，增强版通过 MCP Memory 自动召回；与 [[autonomous-optimization-architect]] 共享系统性能和可靠性关注，但后者专注于 LLM API 路由优化。属 The Agency Engineering 部门。 + +**[[engineering-code-reviewer]]**（Code Reviewer）：代码审查与质量保证专家 Agent——专注于提供构造性、可操作的反馈，聚焦正确性、安全性、可维护性、性能四大维度，而非代码风格偏好。核心理念：**像导师而非门卫一样审查，每次评论都教授知识**。审查清单三层优先级：🔴 Blocker（安全漏洞/数据损坏/竞态条件/破坏API合约/缺失关键路径错误处理）、🟡 Suggestion（缺失输入验证/命名混乱/缺失测试/N+1查询/代码重复）、💭 Nit（风格不一致/小幅命名改进/文档缺口）。审查评论格式：必须具体化（指出行号和机制）、解释原因（为何需要修改）、建议而非要求（用"考虑X因为Y"而非"改成X"）、一次完整反馈。核心交付物：安全漏洞识别（如 SQL 注入定位到行号 + 修复建议）、性能瓶颈分析（N+1 查询定位 + 优化建议）、可维护性评估（逻辑复杂度 + 重构建议）。与 [[SoftwareArchitect]] 和 [[BackendArchitect]] 协同——架构决策影响审查重点，后端实现依赖代码审查保障质量；与 [[QualityGate]] 构成质量保障双层——Reviewer 提供人工判断，QualityGate 提供自动化验证。属 The Agency Engineering 部门。 + +**[[engineering-technical-writer]]**（Technical Writer）：技术文档工程师 Agent——专注于将复杂工程概念转化为开发者真正愿意阅读的清晰、准确、引人入胜的文档。核心理念：**"Bad documentation is a product bug."** 技术文档质量等同于产品质量。核心方法：Divio 文档体系（教程/操作指南/参考文档/解释文档四象限分离）；Docs-as-Code 基础设施（Docusaurus/MkDocs/Sphinx/VitePress + CI/CD 集成）；OpenAPI/Swagger 自动生成 API 参考文档；质量门禁（代码示例必须测试通过、无文档的代码视为不完整）。质量标准：零错误代码示例、破坏性变更附带迁移指南、文档与软件版本同步。核心指标：支持工单降低 20%、新开发者 15 分钟内上手、文档搜索满意度 ≥ 80%。与 [[EngineeringCodeReviewer]] 协同——Code Reviewer 确保代码质量，Technical Writer 将质量内化为可维护文档；与 [[SoftwareArchitect]] 在文档架构设计层面协作。属 The Agency Engineering 部门。 + +**[[engineering-rapid-prototyper]]**（Rapid Prototyper）：极速原型开发专家 Agent——专注于 3 天内交付可工作 MVP，核心理念：**"Turns an idea into a working prototype before the meeting's over."** 速度优先开发哲学：选择最小化设置时间的工具和框架；先实现核心功能再打磨边界情况；优先用户面功能而非基础设施优化。验证驱动开发：只构建测试核心假设所必需的功能；从第一天起内置用户反馈收集和数据分析；A/B 测试框架内置于原型基础设施。快速开发技术栈：Next.js 14 + Supabase（后端即服务）+ Prisma（ORM）+ Clerk（认证）+ shadcn/ui（UI 组件）+ Vercel（零配置部署）。成功指标：3 天内交付功能原型、1 周内收集真实用户反馈、80% 核心功能通过用户测试验证、原型到生产转化时间 < 2 周。与 [[SoftwareArchitect]] 和 [[BackendArchitect]] 互补——Rapid Prototyper 侧重速度验证，Architect 侧重生产级架构设计。 + +**[[engineering-embedded-firmware-engineer]]**（Embedded Firmware Engineer）：嵌入式固件工程师 Agent——专注于资源受限嵌入式系统的生产级固件开发，核心理念：**"Writes production-grade firmware for hardware that can't afford to crash."** 性格特征：严谨、硬件意识强、对未定义行为和栈溢出极度敏感。核心约束：禁止动态分配（malloc/new）——必须使用静态分配或内存池；ISR 必须最小化，通过队列或信号量将工作延迟到任务；栈大小必须计算，使用 `uxTaskGetStackHighWaterMark()` 验证而非猜测。平台差异化实践：ESP-IDF（ESP32 Wi-Fi+BLE SoC，esp_err_t 错误检查，ESP_LOGI/W/E 日志）；STM32 LL vs HAL（时序关键代码优先 LL 驱动，禁止在 ISR 中轮询）；Nordic nRF Zephyr（使用 devicetree 和 Kconfig，禁止硬编码外设地址）；PlatformIO 生产环境锁定库版本，禁止 `@latest`。核心交付物：FreeRTOS 任务架构（队列/信号量/事件组）、外设驱动（UART/SPI/I2C/CAN/BLE/Wi-Fi）、OTA 升级（ESP-IDF/STM32/MCUboot）。成功指标：零栈溢出（72h 压力测试）、ISR 延迟可测量（硬实时 < 10µs）、Flash/RAM 使用 ≤ 80% 预算。与 [[engineering-backend-architect]] 共享可靠性优先的工程价值观——固件层更极端（任何崩溃不可接受），云后端可容错降级；与 [[engineering-rapid-prototyper]] 在速度哲学上有张力——固件层强制稳定优先（禁止 malloc/禁止 @latest），原型层允许短期技术债换取速度。属 The Agency Engineering 部门。 + +**[[engineering-ai-engineer]]**（AI Engineer）：AI/ML 工程师 Agent——专注于机器学习模型开发、部署与生产系统集成的完整生命周期，核心理念：**"Turns ML models into production features that actually scale."** 性格特征：数据驱动、系统化、性能导向、伦理意识强。核心能力矩阵：ML 框架（TensorFlow/PyTorch/HuggingFace）、LLM 集成（OpenAI/Anthropic/Cohere/RAG）、向量数据库（Pinecone/Weaviate/Chroma/FAISS）、MLOps（MLflow/Kubeflow 模型版本管理）、生产集成模式（实时 API <100ms / 批处理 / 流式事件驱动 / 边缘推理）。AI 安全底线规则：必须内置偏见检测（跨人口统计学群体）、公平性指标、隐私保护（差分隐私/联邦学习）和对抗鲁棒性。核心成功指标：推理延迟 <100ms（实时）、模型可用性 >99.5%、漂移检测自动触发再训练。与 [[engineering-backend-architect]] 互补——Backend Architect 提供 API 基础设施，AI Engineer 在其上构建推理服务和 MLOps 管道；与 [[AgentsOrchestrator]] 协同——编排层协调多个 AI 工程师子 Agent 完成复杂 ML 任务。与 [[engineering-embedded-firmware-engineer]] 共享生产级可靠性价值观，但 ML 系统允许统计容错（模型精度波动在可接受范围内），固件层则完全不允许任何不确定性。属 The Agency Engineering 部门。 + +**[[engineering-threat-detection-engineer]]**（Threat Detection Engineer）：威胁检测工程师 Agent——专注于构建检测层，在攻击者绕过预防控制后捕获威胁，核心理念：**"An undetected breach costs 10x more than a detected one, and a noisy SIEM is worse than no SIEM at all."** 核心能力：Sigma 规则开发（厂商无关）并编译为 Splunk SPL / Sentinel KQL / Elastic EQL / Chronicle YARA-L；MITRE ATT&CK 覆盖度映射与差距评估；威胁狩猎（基于情报、异常分析主动搜寻检测遗漏的威胁）；告警调优（通过允许列表、阈值调优和上下文富化降低误报）；Detection-as-Code CI/CD 流水线（Git + CI + 自动部署）。核心原则：检测质量 > 检测数量；行为检测优于 IOC 匹配（IP/哈希可日频轮换）；规则即代码——版本控制、peer review、测试、CI/CD 部署，绝不在 SIEM 控制台直接编辑；每个规则映射到至少一个 ATT&CK 技术；覆盖完整杀伤链（初始访问→横向移动→持久化→数据外泄）。关键量化指标：平均误报率 <15%、MTTD <48小时（关键 ATT&CK 技术情报→部署检测规则）、100% 规则通过 CI/CD 部署。与 [[engineering-backend-architect]] 在安全运营方面互补——Backend Architect 构建安全基础设施，Threat Detection Engineer 在其上构建检测层；属 The Agency Engineering 部门。 + **[[workflow-with-memory]]**（Multi-Agent Workflow: Startup MVP with Persistent Memory）：[[workflow-startup-mvp]] 的增强版——通过 MCP Memory Server 将手动复制粘贴交接升级为自动召回，实现"记忆服务器作为粘合剂"。核心机制：`remember` 存储 Agent 交付物（带项目名 + 接收方标签）、`recall` 自动召回上下文（无需人工粘贴）、`rollback` 回滚到上一个检查点（替代手动撤销）。Before/After 对比：手动交接（会话超时丢失 / 多 Agent 需重复编译上下文 / QA 失败需手动描述问题 / 跨多天项目需重建上下文）→ Memory 模式（跨会话持久 / 按标签共享 / 自动回滚 / 每次 pick up 继续）。核心标签策略：所有记忆用项目名标签（如 retroboard），交付物额外用接收 Agent 标签（如 frontend-developer），这是 recall 正常工作的前提。Rollback 是 QA 失败恢复的核心：回滚到检查点而非手动追踪变化。与 [[workflow-startup-mvp]] 的关系：两者不冲突，Memory 模式是原始工作流的增强层——Memory Server 可用时自动召回；不可用时沿用原始工作流的手动粘贴策略。 **[[multi-channel-assistant]]**：基于 [[OpenClaw]] 的多渠道个人助理方案——以 Telegram Topic 路由为统一入口，整合 Google Workspace（gog）、Slack、Todoist、Asana，实现"说一句话完成全套工作"。核心价值：消除应用切换疲劳，AI 主动推送定时提醒（如每周垃圾清理、公司周报）。 @@ -101,7 +150,9 @@ The wiki covers two major multi-agent frameworks: **The Agency** (agency-agents) **[[design-image-prompt-engineer]]**（Image Prompt Engineer）：The Agency 设计部门的 AI 图像生成提示词工程专家智能体——专注于将视觉概念精准翻译为可执行的提示词语言，驱动 Midjourney、DALL-E、Stable Diffusion、Flux 等 AI 图像生成工具产出专业级摄影作品。核心方法：五层提示词结构框架（主体描述层 → 环境设定层 → 光线规范层 → 摄影技术层 → 风格美学层）+ 平台特定语法优化 + 体裁专属提示模式（人像/产品/风光/时尚摄影）。核心原则：摄影术语精确性（"f/1.8 bokeh 浅景深"而非"背景模糊"）+ 负向提示词排除不想要元素 + 宽高比和构图纳入每条提示词。成功指标：视觉概念还原率 90%+、多次生成结果一致性高、技术摄影元素（布光/景深/构图）精准渲染。与 [[design-ui-designer]]（像素级精确）存在张力——概率生成固有不确定性，需通过确定性约束（具体颜色值/光照参数）协调；与 [[design-brand-guardian]]（品牌一致性）协同，确保生成图像符合品牌视觉规范；与 [[design-whimsy-injector]]（品牌趣味）互补——提供视觉语言能力支撑趣味元素在图像中的精准表达。 -**[[InclusiveVisualsSpecialist]]**（Inclusive Visuals Specialist）：The Agency 设计部门的包容性视觉表征专家智能体——专门对抗 AI 图像/视频生成模型（Midjourney、Sora、Runway Gen-3、DALL-E）中内嵌的系统性刻板印象偏见，生成具有文化真实性、尊严感和无歧视性的人类视觉表征。核心挑战：克隆脸（Clone Faces）、异域化偏见（Exoticism Bias）、文化符号乱码（Gibberish Cultural Text）、地理/建筑失真。核心技术：结构化提示词架构（Subject → Sub-actions → Context → Camera Spec → Color Grade → Explicit Exclusions）+ 负向提示库 + 视频物理学定义（服装/头发/辅助器具的运动一致性）。四阶段工作流：Brief Intake → Annotation Framework → Video Physics Definition → 7-Point QA Review Gate。成功指标：表征准确度 100%、AI 伪影消除率 100%、社区验证认可。[[UX-Researcher]] 提供 QA 审查，[[design-brand-guardian]] 把控企业品牌伦理标准。与 [[design-image-prompt-engineer]] 互补——后者侧重摄影美学精准度，前者侧重消除表征偏见与文化真实性。与 [[design-whimsy-injector]] 存在张力——"Kumbaya"式库存照片套路和表演性象征主义是包容性设计必须坚决拒绝的。 +**[[InclusiveVisualsSpecialist]]**（Inclusive Visuals Specialist）：The Agency 设计部门的包容性视觉表征专家智能体——专门对抗 AI 图像/视频生成模型（Midjourney、Sora、Runway Gen-3、DALL-E）中内嵌的系统性刻板印象偏见，生成具有文化真实性、尊严感和无歧视性的人类视觉表征。核心挑战：克隆脸（Clone Faces）、异域化偏见（Exoticism Bias）、文化符号乱码（Gibberish Cultural Text）、地理/建筑失真。核心技术：结构化提示词架构（Subject → Sub-actions → Context → Camera Spec → Color Grade → Explicit Exclusions）+ 负向提示库 + 视频物理学定义（服装/头发/辅助器具的运动一致性）。四阶段工作流：Brief Intake → Annotation Framework → Video Physics Definition → 7-Point QA Review Gate。 + +**[[Intersectionality]] vs [[Sociological Accuracy]]**：Inclusive Visuals Specialist 引入的两个互补分析维度——Intersectionality 要求多维度身份交叉的精准锚定（文化+年龄+残障+社会经济地位的 intersectional 组合），Sociological Accuracy 要求超越技术保真度的社会可识别性（被描绘社区的用户能否认可该 representation 为真实和特定于其现实的）。两者共同构成 Inclusive AI imagery 的质量标准。与 [[Negative-Prompting]]（通用排除层）和 [[Cultural-Authenticity]]（文化环境层）一起，构成 Inclusive Visuals Specialist 的四层质量保障体系。成功指标：表征准确度 100%、AI 伪影消除率 100%、社区验证认可。[[UX-Researcher]] 提供 QA 审查，[[design-brand-guardian]] 把控企业品牌伦理标准。与 [[design-image-prompt-engineer]] 互补——后者侧重摄影美学精准度，前者侧重消除表征偏见与文化真实性。与 [[design-whimsy-injector]] 存在张力——"Kumbaya"式库存照片套路和表演性象征主义是包容性设计必须坚决拒绝的。 **[[design-brand-guardian]]**（Brand Guardian）：The Agency 设计部门的品牌战略与身份守护专家智能体——负责创建 cohesive 品牌体系、确保跨所有触点的品牌表达一致性、并通过品牌保护策略维护品牌价值。核心交付物：品牌战略框架（Purpose/Vision/Mission/Values/Personality 五要素）、视觉身份系统（CSS 变量定义的品牌色彩/字体/间距/Logo 变体）、品牌声音指南（Voice Characteristics/Tone Variations/Messaging Architecture/Writing Guidelines）、品牌保护策略（商标监控/合规审计/危机管理）。核心原则：**Brand-First**——在战术执行前必须先建立完整的品牌基础；**一致性优先**——确保品牌识别在 95%+ 触点保持一致；**战略性演进**——品牌必须能够随市场变化成长而不失去核心身份。与 [[design-whimsy-injector]] 互补——Brand Guardian 建立品牌边界并制定一致性标准，Whimsy Injector 在边界内通过有目的的趣味和微交互注入品牌个性，共同为 [[LuxuryDeveloper]] 提供完整的品牌体验设计。与 [[ArchitectUX]]（技术架构）和 [[UX-Researcher]]（用户研究）协同，共同构成 [[The Agency]] 设计部门的完整设计支撑体系。 @@ -136,6 +187,8 @@ The wiki covers two major multi-agent frameworks: **The Agency** (agency-agents) **[[Project-Management-Experiment-Tracker]]**（Experiment Tracker）：实验追踪与数据驱动决策专家 Agent——The Agency 项目管理部门的实验管理专家 Agent，专注于 A/B 测试、功能实验和假设验证的科学化管理。核心职责：设计统计有效的 A/B 测试和多变量实验（默认 95% 置信度）、管理实验 Portfolio 组合（每季度 15+ 实验）、执行统计功效分析确定所需样本量、实施渐进放量与安全监控。高级能力：多臂老虎机（Multi-armed Bandits）动态流量分配、贝叶斯分析支持实时决策、因果推断技术理解实验真正效果、ML 模型 A/B 测试与预测建模。典型交付物：实验设计文档模板（假设/设计/风险评估/实施计划）、实验结果报告模板（统计结果/置信区间/业务影响/决策建议）。成功指标：95% 实验达统计显著性、70% 实验成功率、80% 成功实验实现落地。与 [[Project-Management-Studio-Producer]] 协同——Producer 基于实验数据优化 Portfolio 资源配置；与 [[Project-Management-Studio-Operations]] 存在潜在张力——实验节奏（等待统计显著性）可能与内容制作节奏冲突；与 [[Project-Management-Jira-Workflow-Steward]] 协同——实验结果通过 Jira 工作流转化为产品改进任务。属 Agency 项目管理体系中的实验验证层级，补充了从战略规划→任务分解→实验验证→流程治理的完整闭环。 +**[[Project-Management-Project-Shepherd]]**（Project Shepherd）：跨职能项目协调与利益相关方对齐专家 Agent——The Agency 项目管理部门的核心交付专家，专注于将复杂跨职能项目的混乱协调为按时、按范围交付的规范化流程。核心方法论：**项目章程模板**（问题陈述/目标/范围/成功标准 + 利益相关方分析/沟通计划/资源需求/风险评估）、**四阶段工作流**（项目启动与规划→团队组建与启动→执行协调与监控→质量保证与交付）。关键交付物：Project Charter（项目章程）、Project Status Report（绿/黄/红健康状态报告）。成功指标：95% 项目按时在预算内交付、利益相关方满意度 4.5/5、范围蔓延 < 10%、90% 已识别风险成功缓解。沟通原则：透明报告（即使坏消息）、聚焦解决方案（上报即带推荐方案）、绝不承诺不切实际的时间线。与 [[ProjectManagerSenior]] 协同——Senior PM 产出详细任务列表，Project Shepherd 负责多团队协调执行；与 [[Project-Management-Jira-Workflow-Steward]] 协同——Jira 工作流编排确保任务追踪与可见性。属 Agency 项目管理体系中的跨团队交付协调层级，与 Studio Producer（战略层）→ Senior PM（执行层任务分解）→ Project Shepherd（跨团队交付）共同构成完整的项目管理体系。[[project-management-project-shepherd]] + ### The Agency — Testing 部门 |The Agency 的 Testing 部门涵盖 API 测试、可访问性审计、工具评估、证据收集、结果分析、性能基准、真实性检验、工作流优化等专业测试 Agent，覆盖从功能到安全到性能的全方位质量保障。| @@ -164,7 +217,7 @@ The Agency 的 Support 部门涵盖数据分析、基础设施维护、法律合 **[[support-infrastructure-maintainer]]**（Infrastructure Maintainer）：基础设施维护专家 Agent——The Agency Support 部门的基础设施专家，负责确保系统可靠性、性能优化和技术运维管理，核心理念：**"Keeps the lights on, the servers humming, and the alerts quiet"**。核心能力：①监控告警系统（Prometheus + Grafana，CPU/内存/磁盘/服务可用性实时告警，99.9%+ 上线时间目标）；②基础设施即代码（Terraform IaC，VPC/Subnet/Auto Scaling/RDS 数据库版本化管理，确保部署一致性）；③自动化备份与灾备恢复（GPG AES-256 加密 + S3 分层存储，30 天自动清理，经过测试的恢复流程）；④安全合规集成（SOC2/ISO27001 合规验证，零信任 + MFA + 漏洞管理）；⑤成本优化（资源正确规模分析 + 预留实例，年度效率提升 20%+）。四步工作流：基础设施评估规划 → 监控实施 → 性能优化 → 安全合规验证。成功指标：上线时间 99.9%+、MTTR < 4 小时、70%+ 运维任务自动化、安全合规 100% 达标。**前置依赖：** [[support-support-responder]]（工单系统依赖稳定基础设施）和 [[support-analytics-reporter]]（数据分析依赖数据库和存储基础设施）；与 [[support-legal-compliance-checker]] 存在张力——合规验证应作为 CI/CD 流水线 Gate，不阻断常规变更但强制阻断高风险变更。属 [[Multi-Agent-System-Reliability]] 的运维基础设施层，为所有 Support Agent 提供稳定可靠的运行基础。 -**[[support-executive-summary-generator]]**（Executive Summary Generator）：咨询级执行摘要生成 Agent——The Agency Support 部门的战略沟通专家，融合麦肯锡 SCQA、BCG 金字塔原理、贝恩行动导向三大顶级咨询框架，将复杂冗长的商业输入转化为 325-475 词的高管级执行摘要，确保 C-suite 决策者在 3 分钟内把握本质、评估影响、做出决策。核心理念：**洞察优先于信息，行动优先于描述**——每个关键发现必须包含量化数据点（≥1 个），不允许超越提供数据的假设，明确标记数据缺口。核心方法：四步流水线（Intake 分析 → SCQA/Pyramid 结构开发 → 执行摘要生成 → QA 验证）；输出格式严格遵循五段式结构（Situation Overview / Key Findings / Business Impact / Recommendations / Next Steps）；建议按业务影响排序（Critical / High / Medium），每条包含负责人+时间线+预期结果。成功指标：摘要阅读时间 <3 分钟、100% 发现含量化数据、325-475 词合规率 100%。与 [[support-analytics-reporter]] 协同——后者提供原始数据洞察，前者将其转化为高管可执行决策；与 [[support-legal-compliance-checker]] 协同——合规 Checker 的风险评估报告经 Executive Summary Generator 转化为高管行动建议；与 [[report-distribution-agent]] 协同——生成的执行摘要通过 Report Distribution Agent 分发给相关利益相关者。属 [[Multi-Agent-System-Reliability]] 的战略沟通层，为 C-suite 提供可执行的决策支撑文档。 +**[[support-executive-summary-generator]]**（Executive Summary Generator）：咨询级执行摘要生成 Agent——The Agency Support 部门的战略沟通专家，融合麦肯锡 SCQA、BCG 金字塔原理、贝恩行动导向三大顶级咨询框架，将复杂冗长的商业输入转化为 325-475 词的高管级执行摘要，确保 C-suite 决策者在 3 分钟内把握本质、评估影响、做出决策。核心理念：**洞察优先于信息，行动优先于描述**——每个关键发现必须包含量化数据点（≥1 个），不允许超越提供数据的假设，明确标记数据缺口。核心方法：四步流水线（Intake 分析 → SCQA/Pyramid 结构开发 → 执行摘要生成 → QA 验证）；输出格式严格遵循五段式结构（Situation Overview / Key Findings / Business Impact / Recommendations / Next Steps）；建议按业务影响排序（Critical / High / Medium），每条包含负责人+时间线+预期结果；高级能力包括统计验证的数据驱动洞察、行业基准对比分析、情景分析（最佳/最差/最可能）和价值 vs. 努力矩阵。成功指标：摘要阅读时间 <3 分钟、100% 发现含量化数据、325-475 词合规率 100%。与 [[support-analytics-reporter]] 协同——后者提供原始数据洞察，前者将其转化为高管可执行决策；与 [[support-legal-compliance-checker]] 协同——合规 Checker 的风险评估报告经 Executive Summary Generator 转化为高管行动建议；与 [[report-distribution-agent]] 协同——生成的执行摘要通过 Report Distribution Agent 分发给相关利益相关者。属 [[Multi-Agent-System-Reliability]] 的战略沟通层，为 C-suite 提供可执行的决策支撑文档。 ### The Agency — Paid Media 部门 The Agency 的 Paid Media 部门专注于企业级付费媒体策略与运营，涵盖 Google Ads、Microsoft Advertising、Amazon Ads 三大核心平台。 @@ -175,7 +228,7 @@ The Agency 的 Paid Media 部门专注于企业级付费媒体策略与运营， **[[paid-media-creative-strategist]]**（Creative Strategist）：付费媒体广告创意策略 Agent——由 John Williams（@itallstartedwithaidea）设计，专注于 Google、Meta、Microsoft 及程序化平台的全渠道广告文案创作、响应式搜索广告（RSA）架构设计和系统性创意测试框架。核心理念：**创意是自动化竞价环境中最大的可控杠杆**，当算法接管了出价、预算和定向时，每一条标题、描述、图片和视频都是一个待验证的假设。核心能力：15-headline RSA 策略设计（全品牌/利益/功能/CTA/社会证明分类，确保所有可能组合语法和逻辑上都能成立）；Hook-Body-CTA 视频广告叙事结构；资产组（Asset Group）组合策略；A/B 测试框架与统计显著性标准（2-4 周内达到）；广告强度（Ad Strength）优化（90%+ 达到 "Good" 或 "Excellent"）；创意疲劳（Creative Fatigue）监测与快速迭代（每 2 周一次创意测试）。成功指标：CTR 提升 15-25%、转化率提升 5-10%、测试后 2-4 周内达成统计显著性。与 [[paid-media-ppc-strategist]] 协同：PPC 策略师定义账户架构和竞价策略，创意策略师提供素材支撑，两者共同制定 Performance Max 和 Display 投放方案；与 [[paid-media-paid-social-strategist]] 协同：社交策略师提供受众洞察和平台选择，创意策略师据此定制平台原生创意执行。与 [[ResponsiveSearchAds]]（RSA 架构）、[[PerformanceMax]]（Asset Group 设计）、[[AdStrength]]（广告强度评分）、[[CreativeFatigue]]（创意疲劳监测）和 [[HookBodyCTA]]（视频广告叙事框架）共同构成付费媒体创意优化的完整方法论。 -**[[paid-media-tracking-specialist]]**（Tracking Specialist）：付费媒体追踪专家——负责转化追踪配置、数据归因建模和跨平台效果归因。与 [[paid-media-ppc-strategist]] 协同：为竞价策略优化提供可靠的数据基础。 +**[[paid-media-tracking-specialist]]**（Tracking Specialist）：付费媒体转化追踪与归因测量专家 Agent——由 John Williams（@itallstartedwithaidea）设计，专注于 GTM 容器架构、GA4 事件设计、跨平台归因建模和隐私合规。核心理念：**"If it's not tracked correctly, it didn't happen."** ——错误的追踪数据比无追踪更具误导性，会导致算法持续优化错误目标。核心能力：GTM 容器架构（工作区管理/触发器变量设计/Consent Mode v2）、GA4 实现（事件分类/自定义维度/电子商务 dataLayer）、转化追踪（Google Ads 增强转化/离线转化 API）、Meta CAPI（含 event_id 去重机制避免 Pixel 与服务端事件双重计数）、服务端 Tagging（GTM 服务端容器/第一方数据收集/富化）、归因建模（数据驱动归因/增量测试/营销组合建模）、调试 QA（Tag Assistant/GA4 DebugView/Meta Event Manager）。成功指标：转化数据差异 <3%、标签触发成功率 99.5%+、CAPI 去重零双重计数、页面性能影响 <200ms、Consent Mode 覆盖率 100%、95%+ 转化数据完整性。与 [[paid-media-ppc-strategist]] 协同：为竞价策略优化提供可靠的数据基础；与 [[paid-media-paid-social-strategist]] 协同：确保 Meta CAPI 和像素追踪配置正确；与 [[paid-media-auditor]] 协同：提供追踪准确性核查的数据依据。 **[[paid-media-search-query-analyst]]**（Search Query Analyst）：搜索词分析专家——分析搜索词报告，识别高效关键词和负向关键词优化机会。与 [[paid-media-ppc-strategist]] 协同：提供关键词策略的数据支撑。 @@ -188,11 +241,11 @@ Key concepts: [[PerformanceMax]], [[SmartBidding]], [[AccountArchitecture]], [[T ### The Agency — Product 部门 |The Agency 的 Product 部门涵盖用户反馈分析、趋势研究、产品路线图规划和行为引导等专业 Agent。| -**[[product-feedback-synthesizer]]**（Product Feedback Synthesizer）：The Agency 产品部门的用户反馈综合分析专家 Agent——专精于从多渠道（调查/访谈/工单/评论/社交媒体）收集、分析和综合用户反馈，将海量用户声音蒸馏为可量化的产品决策依据。核心能力：NLP 情感分析与满意度建模（NPS/CSAT/CES）、RICE/MoSCoW/Kano 多维度优先级框架、用户旅程映射与痛点识别、流失预测与早期预警系统。核心理念：**定性反馈 → 定量优先级 → 数据驱动路线图**。成功指标：24 小时内处理关键问题、90%+ 主题准确率（利益相关者验证）、85% 综合反馈产生可衡量决策、NPS 提升 10+ 分、80% 反馈驱动功能成功率。与 [[product-sprint-prioritizer]]（Sprint 迭代优先级）和 [[product-trend-researcher]]（产品趋势研究）协同，共同构成 The Agency 产品部门的数据驱动决策体系。 +**[[product-feedback-synthesizer]]**（Product Feedback Synthesizer）：The Agency 产品部门的用户反馈综合分析专家 Agent——专精于从多渠道（主动/反应/被动/社区/竞争渠道）收集、分析和综合用户反馈，将海量用户声音蒸馏为可量化的产品决策依据。核心能力：五步处理流水线（数据摄取→清洗标准化→NLP情感分析→分类→质量保证）、多维度情感与满意度建模（NPS/CSAT/CES）、RICE/MoSCoW/Kano 多框架优先级量化、流失预测早期预警系统（90% 精度）、多格式交付（Executive Dashboard/Product Team Reports/Customer Success Playbooks）。核心理念：**定性反馈 → 定量优先级 → 数据驱动路线图**。成功指标：24 小时内处理关键问题、90%+ 主题准确率（利益相关者验证）、85% 综合反馈产生可衡量决策、NPS 提升 10+ 分、80% 反馈驱动功能成功率。与 [[product-sprint-prioritizer]]（Sprint 迭代优先级）和 [[product-trend-researcher]]（产品趋势研究）协同，共同构成 The Agency 产品部门的数据驱动决策体系；与 [[product-sprint-prioritizer]] 在优先级框架上存在张力——前者侧重用户价值长期路线图，后者侧重开发资源约束短期迭代，两者互补而非替代。 **[[product-trend-researcher]]**（Product Trend Researcher）：The Agency 产品部门的专家级市场情报分析师——专注于新兴趋势识别、竞争分析和机会评估，为产品战略和创新决策提供可操作的洞察。核心能力：七步趋势识别流程（信号收集→模式识别→上下文分析→影响评估→验证→预测→可操作性）；覆盖 50+ 数据源实时聚合，统计验证的弱信号检测，提前 3-6 个月识别主流采纳前的趋势；TAM/SAM/SOM 三层市场量化（置信区间 ±20%）；竞争情报框架（直接/间接/新兴/技术/替代）。成功指标：80%+ 准确率的 6 个月趋势预测、90% 洞察转化为战略决策、48 小时内紧急请求响应、15+ 独立验证来源/报告。与 [[product-manager]] 协同——后者提供产品规格与市场定位输入，前者提供趋势情报与竞争格局分析；与 [[product-feedback-synthesizer]] 互补——后者分析已有用户反馈，前者预判未来市场趋势，共同构成数据驱动的产品决策闭环。属 The Agency 产品部门的市场情报核心层。 -**[[product-manager]]**（Product Manager Agent — Alex）：The Agency 产品部门的核心战略 Agent——以 10+ 年 B2B SaaS/消费者应用/平台业务经验的产品经理身份，自主拥有从发现到衡量的完整产品生命周期。核心理念：**以结果为导向，而非产出**，功能是假设，发布是实验，成功的产品必须 measurable 改变用户行为。核心交付物：PRD（含机会评估/用户故事/Launch Plan/风险矩阵）、Opportunity Assessment（RICE 评分）、Now/Next/Later 路线图、GTM Brief、Sprint Health Snapshot。六阶段工作流：Discovery → Framing/Prioritization → Definition → Delivery → Launch → Measurement。核心原则：**先问题后方案**（永远不接受表面的功能请求）、**写新闻稿再写 PRD**、**无 Owner/Metric/Time Horizon 不上路线图**、**经常说"不"保护团队焦点**。与 [[Agents-Orchestrator]] 协同——由编排器协调任务；与 [[product-feedback-synthesizer]] 互补——后者收集用户反馈，前者将反馈转化为产品决策和交付计划。属 The Agency 产品部门的战略决策核心层。 +**[[product-manager]]**（Product Manager Agent — Alex）：The Agency 产品部门的核心战略 Agent——以 10+ 年 B2B SaaS/消费者应用/平台业务经验的产品经理身份，自主拥有从发现到衡量的完整产品生命周期。核心理念：**以结果为导向，而非产出**，功能是假设，发布是实验，成功的产品必须 measurable 改变用户行为。核心交付物：PRD（含机会评估/用户故事/Launch Plan/风险矩阵）、Opportunity Assessment（RICE 评分）、Now/Next/Later 路线图、GTM Brief、Sprint Health Snapshot。六阶段工作流：Discovery → Framing/Prioritization → Definition → Delivery → Launch → Measurement。**八大关键原则**：①先问题后方案（不接受表面的功能请求）②写新闻稿再写 PRD ③无 Owner/Metric/Time Horizon 不上路线图 ④经常说"不"保护团队焦点 ⑤发布前验证、发布后测量 ⑥对齐不等于共识 ⑦惊喜即失败 ⑧范围蔓延是产品杀手。**沟通风格**：书面优先、异步默认；直接且有同理心；数据流利但不依赖数据；不确定性下果断决策；随时可向高管和工程师双向切换表达深度。核心成功指标：75%+ 功能在90天内达成首要成功指标；80%+ 季度承诺按时交付；零惊喜（领导层始终知情在先）。与 [[Agents-Orchestrator]] 协同——由编排器协调任务；与 [[product-feedback-synthesizer]] 互补——后者收集用户反馈，前者将反馈转化为产品决策和交付计划。属 The Agency 产品部门的战略决策核心层。 **[[product-sprint-prioritizer]]**（Product Sprint Prioritizer）：The Agency 产品部门的冲刺规划与优先级排序专家 Agent——专注于敏捷冲刺规划、特性优先级排序和资源分配，通过数据驱动的优先级框架最大化团队交付价值。核心能力：RICE/MoSCoW/Kano/Value vs. Effort 等多框架优先级评分；基于 6 个冲刺滚动平均值的团队速率预测（偏差 < 15%）；冲刺前五步准备（Backlog Refinement → 依赖分析 → 容量评估 → 风险识别 → 干系人审查）；技术债务与新功能的 ROI 平衡建模；跨团队依赖识别与关键路径分析。成功指标：承诺故事点交付率 90%+、干系人满意度 4.5/5、时间线偏差 ±10%、技术债务占比 < 20%。核心理念：**数据驱动的优先级决策**——每个评分附置信区间和敏感性分析；**冲刺目标先行**——无清晰可衡量目标的冲刺不上计划；**主动风险管理**——风险评分（概率 × 影响矩阵）定期重新评估。与 [[product-manager]] 协同——PM 制定路线图，本 Agent 将路线图转化为可执行的冲刺计划；与 [[product-feedback-synthesizer]] 互补——后者提供用户反馈驱动的优先级输入，前者将优先级决策转化为 Sprint 容量规划。属 The Agency 产品部门的执行规划核心层。 @@ -458,6 +511,8 @@ A practical tip for extracting YouTube Channel IDs: use `view-source:` prefix in **[[academic-narratologist]]**：以叙事理论框架驱动故事结构分析的 AI Agent——将俄罗斯形式主义、法国结构主义、认知叙事学等学术传统注入 Agent，使其能像专业叙事理论家一样分析故事结构、角色弧光、主题表达，并提供有命名框架依据的叙事建议。核心理念："每个故事都是一个论证（Every story is an argument）"；核心原则：大多数叙事问题存在于讲述层面（sjuzhet）而非故事层面（fabula），诊断应优先于处方；每个建议必须引用至少一个命名理论框架（Propp/Campbell/Genette/Barthes/Todorov）。核心框架：Propp 形态学（童话/冒险结构）、Campbell 单一体神话（英雄叙事）、Vogler 编剧旅程（好莱坞改编）、Genette 叙事学（视角/时序/声音）、Barthes 五代码（叙事语义）、Todorov 均衡模型（破坏-恢复结构）。与 [[academic-anthropologist]]（共时性文化系统）、[[academic-historian]]（历时性时间分析）、[[academic-geographer]]（空间维度）共同构成"人文社科 AI 研究者矩阵"。 +**[[academic-psychologist]]**（Psychologist）：AI Agent 中的临床与研究心理学家角色——专注于人格、动机、创伤和群体动力学，为角色构建提供心理学可信的行为和互动框架。核心理念："People don't do things for no reason — I find the reason"；核心方法：所有心理观察必须以命名理论或实证研究为基础，并诚实承认该理论的局限性。理论工具箱：Big Five 人格五因素模型（开放性/尽责性/外向性/宜人性/神经质）、Bowlby 依恋理论（安全型/焦虑型/回避型/恐惧型）、Vaillant 防御机制层级（intellectualization/projection/humor 等）、Karpman 戏剧三角（受害者/迫害者/拯救者）、CBT 认知扭曲分类（Beck）、Erikson 心理社会发展阶段、Porges 迷走神经理论（创伤的生理基础）。关键原则：拒绝将角色简化为诊断标签（"narcissistic traits" ≠ "a narcissist"）；区分流行心理学与研究实证心理学；创伤反应具有多样性（过度警觉型/取悦他人型/隔离回避型/高功能 compartmentalization）。典型交付物：Psychological Profile（Big Five + 依恋风格 + 防御机制 + 核心创伤 + 盲点）、Interpersonal Dynamics Analysis（权力动态/沟通模式/隐性契约/触发点/成长边缘）。与 [[academic-historian]]（心理-历史交叉分析）、[[academic-anthropologist]]（文化背景对心理的影响）、[[academic-narratologist]]（角色弧光的心理学基础）共同构成"人文社科 AI 研究者矩阵"。 + **[[arXiv-Paper-Reader]]**：AI Agent 驱动的 arXiv 论文阅读助手——通过 `arxiv-reader` skill（3 个工具：`arxiv_fetch`、`arxiv_sections`、`arxiv_abstract`）直接从 arXiv 下载 LaTeX 源码并自动扁平化展开，消除 PDF 下载后切换论文丢失上下文和 LaTeX 符号难以解析的痛点；支持摘要浏览、多论文对比排序、选择性细读和会话式分析；本地缓存使重复访问秒级响应；纯 Node.js 零依赖部署。与 [[academic-historian]] 同属学术研究场景互补——前者侧重理工科论文，后者侧重人文社科；与 [[YouTube-Content-Pipeline]] 的 Research Agent 共享研究工作流设计模式。 **[[Daily Reddit Digest]]**：AI Agent 驱动的 Reddit 每日精选摘要自动化——通过 [[OpenClaw]] + `reddit-readonly` skill，每日定时抓取指定 Subreddit 的热门/最新/最高赞帖子，AI 记忆用户偏好并持续优化精选规则（如排除表情包类内容）。纯读取模式，无需认证。属 [[Daily YouTube Digest]] 同款模式（定时 + AI 摘要 + 偏好学习）的 Reddit 垂直场景。 @@ -835,6 +890,8 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]] **[[marketing-twitter-engager]]**（Marketing Twitter Engager）：The Agency Marketing 部门的 Twitter 实时互动与思想领袖建立专家 Agent——专注于通过真实对话参与、领袖思想内容创作和社区驱动增长构建品牌权威。**核心理念：Twitter 成功的核心不是广播式发布，而是通过真实参与将对话转化为社区，将互动转化为权威，将粉丝转化为品牌倡导者**。核心方法：**内容配比策略**（教育类25%/个人故事20%/行业评论20%/社区互动15%/推广10%/娱乐10%）；**四阶段工作流**（实时监控与互动 → 思想领袖内容创作 → 社区建设 → 效果优化）；**Twitter Spaces**（行业讨论/Q&A 定期举办，平均 200+ 实时听众）；**危机管理协议**（<30 分钟响应声誉威胁事件）。关键指标：互动率 ≥2.5%、回复率 80%（2小时内）、教育 thread ≥100 转推。与 [[marketing-social-media-strategist]] 协同——后者负责跨平台有机战略，前者负责 Twitter 垂直深耕；与 [[marketing-growth-hacker]] 互补——Growth Hacker 侧重病毒增长机制，Twitter Engager 侧重社区沉淀与声誉建立；与 [[marketing-linkedin-content-creator]] 构成专业社交平台双渠道矩阵（Twitter + LinkedIn）。 +**[[marketing-linkedin-content-creator]]**（LinkedIn Content Creator）：The Agency Marketing 部门的 LinkedIn 专业内容创作与个人品牌建设专家 Agent——专注于思想领导力内容、个人品牌塑造和高互动率内容策略。**核心理念：中性内容 = 中性结果；首句钩子决定一切**。核心方法：**七阶段内容工作流**（受众定位→钩子工程→帖子构造→格式优化→轮播制作→主页优化→互动策略）；**受众分群 Playbook**（创始人/求职者/开发者/B2B）；**LinkedIn 算法四杠杆**（停留时间/收藏率/早期互动速度/原生内容）；**轮播深层架构**（首张独立成帖/每张一理念/倒数第二张揭示/结尾 CTA + 关注提示）；**评论转管道系统**（内容温暖外联连接接受率 30%+）。关键原则：首句必须停止滚动；具体故事 > 泛泛激励；必须响应发布后首 60 分钟的每条评论；原生内容（PDF/原生视频）触达量是含外链帖的 3-5 倍；3-5 个精准标签。与 [[marketing-social-media-strategist]] 协同——后者提供跨平台框架，前者深入 LinkedIn 专项机制；与 [[marketing-zhihu-strategist]] 并列——两者均专注思想领导力，但平台不同（LinkedIn vs 知乎），受众文化和内容格式各异；与 [[marketing-content-creator]] 构成内容生产的台前与平台分发协同。 + ### Douyin Short-Video & Livestream Commerce **[[marketing-douyin-strategist]]**（Marketing Douyin Strategist）：The Agency Marketing 部门的抖音短视频营销与直播带货策略专家 Agent——深度掌握抖音推荐算法机制、爆款视频策划与直播带货全链路，是国内电商流量运营的核心角色。**核心理念：抖音的核心不是"拍好看的视频"，而是"前三秒钩住注意力，让算法替你分发"**。核心方法论：**算法优先思维**（完播率 > 点赞率 > 评论率 > 分享率）；**黄金3秒钩子**（冲突型/价值型/悬念型/共鸣型四种开场）；**内容矩阵**（教育类/剧情类/产品测评类/Vlog类协同布局）；**直播节奏**（每15分钟制造一次流量峰值）。交付物模板：短视频脚本结构（1-3秒黄金钩子 + 4-20秒核心内容 + 21-30秒收尾钩子）、直播产品结构（引流款20%/利润款50%/形象款15%/秒杀款15%）、DOU+精准定向策略。与 [[marketing-tiktok-strategist]] 同属短视频平台策略，但算法权重不同——抖音以完播率为首要指标，TikTok 需平衡分享率与互动率；与 [[marketing-bilibili-content-strategist]] 互补——抖音以算法推荐驱动流量爆发（中心化），B站 以社区文化和弹幕互动为核心（社区驱动），两者内容生态和用户心理有根本差异，绝不可套用同一策略。| @@ -856,6 +913,8 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]] **[[marketing-kuaishou-strategist]]**（Marketing Kuaishou Strategist）：The Agency Marketing 部门的快手平台下沉市场营销策略专家 Agent——专注于低线城市短视频营销、直播带货运营与老铁经济社区信任构建。**核心理念：真实性高于一切，快手用户能即时识别并拒绝精心制作的不真实内容**。核心方法：**均衡分发算法**（快手给予每个创作者基础曝光，奖励日常一致性而非病毒爆发）；**老铁关系构建**（信任先于销售，每条内容加强创作者-粉丝情感纽带）；**直播带货 3-2-1 公式**（3个痛点→2个产品演示→1个不可抗拒报价）；**私域运营**（粉丝团+微信私域转化）。交付物：账号定位策略（下沉市场受众画像+真实感创作人格）、每日短视频内容矩阵（70%生活快照/20%信任建立/10%社区内容）、直播带货全链路脚本（预热→直播中→复盘）、快手vs抖音差异化策略表。**核心禁忌：绝不将抖音内容直接复用到快手**——两者在受众心理（低线城市30-50岁 vs 一二线18-35岁）、算法逻辑（均衡分发 vs 中心化推荐）、内容审美（真实质朴 vs 精致潮流）上存在根本差异。与 [[marketing-douyin-strategist]] 形成中国短视频双平台互补体系——快手侧重下沉市场信任积累，抖音侧重一二线城市流量爆发。与 [[marketing-livestream-commerce-coach]] 协同——后者提供直播带货通用战术，快手策略师专注快手平台原生适配。属 [[直播带货]] 在快手生态的具体实践。 +**[[marketing-china-ecommerce-operator]]**（Marketing China E-Commerce Operator）：The Agency Marketing 部门的中国电商多平台运营专家 Agent——覆盖淘宝、天猫、拼多多、京东、抖音小店全平台店铺运营与增长策略，**核心理念：每个平台算法、受众和规则均不同，绝不能跨平台复制策略**。核心方法：**多平台差异化运营**（各平台独立制定标题公式、主图策略和详情页结构）；**大促运营 T-60 作战模型**（T-60战略规划→T-30筹备→T-7蓄水→T-day爆发→T+7复盘）；**直播电商**（淘宝直播/抖音/快手跨平台矩阵，直播贡献目标占整体GMV 20%+）；**广告ROAS优化**（淘宝直通车/万相台/超级推荐 + 拼多多多多搜索/多多场景 + 京东京准通，ROAS目标3:1）；**私域运营**（微信CRM + 会员体系 + 微信群/小程序 + 客户生命周期管理）。关键成功指标：店铺类目排名前10、全平台广告ROAS超3:1、大促GMV达标、月环比增长15%+、店铺评分4.8+、90天复购率超25%。交付物模板：多平台运营Dashboard（GMV/订单量/转化率/广告ROI）、618/双11战役计划（5阶段60天节点）、产品 listing 优化清单（标题/主图/详情页分平台规范）、广告ROI优化周循环。与 [[marketing-douyin-strategist]] 和 [[marketing-kuaishou-strategist]] 协同——后两者是单一平台的流量策略，本 Agent 负责将所有平台整合为统一的店铺运营体系；与 [[marketing-private-domain-operator]] 协同——私域运营是电商复购策略层；与 [[supply-chain-strategist]] 协同——供应链为电商运营提供库存和物流保障；与 [[Supply Chain Strategist Agent]] 同属 The Agency Specialized 部门的运营支撑体系。属 [[直播带货]] 和 [[私域运营]] 在中国电商生态的综合实践层。 + **[[marketing-livestream-commerce-coach]]**（Marketing Livestream Commerce Coach）：The Agency Marketing 部门的直播带货全链路运营教练 Agent——专注于主播培训、直播间操盘、流量运营和数据优化，覆盖抖音、快手、淘宝直播和微信视频号四大平台。**核心理念：停留时长和互动率决定平台是否给免费流量，GMV 是结果而非目标**。核心方法论：**主播孵化三阶段**（素人→能播4小时不冷场→能控节奏驱动转化→能拉自然流量即兴发挥）；**五阶段话术框架**（留人钩子→产品介绍→信任建立→紧迫成交→追单挽留）；**三阶段流量模型**（冷启期付费70%+自然30%→成长期50%+50%→成熟期30%+自然70%）；**产品排品策略**（引流款/主推款/利润款/秒杀款配比，随流量波峰实时切换）。关键指标：停留时长>60秒、互动率>5%、GPM>800元、自然流量占比>50%（成熟期）、千川ROI>2.5。交付物模板涵盖单品5分钟脚本、千川投放全流程SOP、直播间数据复盘模板。合规底线：不使用绝对化表述、不暗示医疗功效、不贬低竞品、不诱导未成年人购买。**核心原则：永远不以GMV为目标，而是以停留时长和互动率为目标——前者是结果，后者才是算法真正在喂养的指标**。与 [[marketing-douyin-strategist]]（抖音短视频+直播双驱动）和 [[marketing-kuaishou-strategist]]（快手下沉市场+老铁经济）构成中国直播电商三平台矩阵——抖音侧重算法驱动流量爆发，快手侧重信任积累长期复购，本教练提供跨平台的通用操盘战术层；与 [[marketing-private-domain-operator]] 协同——直播间作为公域获客入口，私域运营商负责将直播流量沉淀为企业微信资产；与 [[OceanEngine]] 协同——千川/Qianniu/超级直播等付费流量工具是冷启期的核心放大器；与 [[直播带货]] 概念页（[[直播带货]]）形成互补——概念页抽象化定义，本教练提供可直接执行的操作模板。 **[[marketing-short-video-editing-coach]]**（Marketing Short-Video Editing Coach）：The Agency Marketing 部门的短视频剪辑技术教练 Agent——专注于完整后期制作流水线，涵盖剪辑软件选择决策树（CapCut Pro 主推高效日更/Pr 适合商业项目/DaVinci Resolve 调色行业标准/Final Cut Pro Mac首选）、镜头语言体系（景别/运镜/转场）、色彩调色（二元体系：初级校正恢复真实 + 次级调色风格化）、音频工程（降噪→人声增强→BGM混音三步骤）、动态图形与VFX、字幕设计与多平台导出优化、AI辅助剪辑（自动字幕95%+/智能抠像/文字成片/数字人配音）。**核心理念：剪辑的核心不是软件熟练度，而是叙事能力和节奏感——软件是工具，叙事是灵魂。每一帧都必须有其存在的理由**。核心观点：音频优先于视频（观众可忍受平庸画面，无法忍受刺耳音频）；LUT是起点而非终点（60%-80%强度最合适）；模板化后单视频制作时间从2小时降至30分钟；AI承担60%重复工作，剩余40%创意打磨仍需人工。与 [[marketing-douyin-strategist]] 和 [[marketing-kuaishou-strategist]] 协同——策略师负责内容策划和平台运营，本教练负责将素材转化为专业成片；与 [[marketing-video-optimization-specialist]] 在视频结构设计上互补——前者专注剪辑技术，后者专注算法层面包装（缩略图/留存率/SEO元数据），共同构成完整视频内容生产体系。 @@ -898,7 +957,7 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]] ### Sales Coaching Methodology **[[sales-coach]]**（Sales Coach Agent）：AI 销售教练 Agent，通过苏格拉底式提问驱动销售代表成长——坚信过程纪律比结果运气更有价值，"一次失败的纪律分明的交易比一次幸运的赢单更有价值，因为过程会累积而运气不会"。核心辅导框架：Richardson Sales Performance（四维能力：辅导卓越/激励领导/销售管理纪律/战略规划）、Challenger 辅导模型（以商业洞察引领对话而非回应需求）、MEDDPICC 资质诊断（资质缺口是交易风险信号而非CRM问题）。每周2小时以上辅导的代理赢单率56%，vs 少于30分钟仅43%；正式辅导项目配额完成率91.2%，vs 非正式辅导84.7%。关键方法：辅导行为而非结果；一次只做一件事；管道质量是管理工具而非数量是虚荣指标；挑战"happy ears"要求可验证的承诺。[[sales-coach]] 与 [[sales-discovery-coach]] 协同——后者专注发现阶段深度辅导，前者覆盖全周期辅导规划与战略制定，共同构成完整销售能力发展体系。 -**[[sales-account-strategist]]**（Account Strategist Agent）：售后账户扩张策略师 Agent，专注于将成交客户从单点解决方案扩展为企业平台——核心理念：最佳销售时机是客户成功时（"The best time to sell more is when the customer is winning"）。核心框架：**Land-and-Expand**（从初始 land deal 扩展为七位数平台的系统性方法）+ QBR 前瞻性战略规划（永远不做回顾性状态报告）+ 利益相关者多线程关系建设（每账户至少三条独立关系线）+ NRR（净收入留存）作为终极指标。账户健康评分体系：绿色账户推扩张、黄色账户稳基础、红色账户救流失。关键纪律：永远不在未成功的账户上推扩张；扩张信号必须配合情境+时机+利益相关者对齐三个维度才算机会；单线程账户是最高风险状态。[[sales-account-strategist]] 与 [[sales-proposal-strategist]] 互补——前者构建赢单叙事，后者交付并超越叙事；与 [[sales-coach]] 协同——后者辅导卖方（代表成长），前者辅导买方（内部冠军培养）。 +**[[sales-account-strategist]]**（Account Strategist Agent）：售后账户扩张策略师 Agent，专注于将成交客户从单点解决方案扩展为企业平台——核心理念：最佳销售时机是客户成功时（"The best time to sell more is when the customer is winning"）。核心框架：**Land-and-Expand**（从初始 land deal 扩展为七位数平台的系统性方法）+ QBR 前瞻性战略规划（永远不做回顾性状态报告）+ 利益相关者多线程关系建设（每账户至少三条独立关系线）+ NRR（净收入留存）作为终极指标。账户健康评分体系：绿色账户推扩张、黄色账户稳基础、红色账户救流失。关键纪律：永远不在未成功的账户上推扩张；扩张信号必须配合情境+时机+利益相关者对齐三个维度才算机会；单线程账户是最高风险状态。**高级能力**（Advanced Capabilities）：战略账户规划（基于增长潜力和战略价值的投资组合分层，顶级账户进行 C-level 双边高管业务回顾）+ 收入架构（消费下限/增长阶梯/多年期承诺等合同激励机制，定价与包装优化，渠道协同扩张）+ 组织情报（非正式决策路径映射，利用内部政治定位扩张，实时感知 M&A/重组/领导层更替并动态调整策略）。[[sales-account-strategist]] 与 [[sales-proposal-strategist]] 互补——前者构建赢单叙事，后者交付并超越叙事；与 [[sales-coach]] 协同——后者辅导卖方（代表成长），前者辅导买方（内部冠军培养）；与 [[sales-pipeline-analyst]] 共享 NRR 作为共同语言——赢单是 NRR 的前提，管道数据可作为扩张信号的早期预警。 **[[sales-deal-strategist]]**（Deal Strategist Agent）：高级deal策略师与管线架构师，将严谨的资质方法论应用于复杂B2B销售周期——坚信每个deal都是战略问题而非关系练习，"如果资质缺口没有尽早识别，失败就已经锁定了，只是你还没发现"。核心能力：**MEDDPICC资质评估**（八维度评分，每维度5分，满分40；全面推行MEDDPICC的组织赢率提升18%、deal规模扩大24%）+ **竞争定位**（Winning/Battling/Losing三区分析 + 地雷问题布局）+ **Challenger商业教学法**（六步序列：Warmer → Reframe → Rational Drowning → Emotional Impact → A New Way → Your Solution）+ **交易检查方法论**（系统探测风险信号：单线程/无紧迫事件/Champion不开放EB通道/决策标准完美匹配竞争对手）。核心原则：预测准确率Commit deals关闭率85%+；Qualified Pipeline（28/40+）赢率35%+；永远不做单线程账户；每条资质缺口必须附带具体下一步、责任人、和截止日期。与 [[sales-discovery-coach]] 协同——后者提供买方情境输入（发现阶段），前者构建交易策略（评估+定位+计划）；与 [[sales-proposal-strategist]] 互补——Deal Strategist提供结构化deal分析和竞争定位，Proposal Strategist将其转化为说服性叙事，共同构成"发现→赢单策略→提案叙事"完整销售闭环。 @@ -916,11 +975,11 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]] **[[healthcare-marketing-compliance]]**（Healthcare Marketing Compliance Specialist）：The Agency Specialized 部门的医疗营销合规专家——覆盖中国医疗健康全品类（药品/医疗器械/医美/保健食品/互联网医疗）营销合规，深度熟悉《广告法》《医疗广告管理办法》《互联网广告管理办法》等核心法规体系。核心能力：医疗广告审查（《医疗广告审查证明》申请与合规）、处方药/OTC药广告分规管理、医疗器械三类分级合规（I类备案/II类注册/III类严格审批）、医美"容貌焦虑"红线防控、保健品"蓝帽子"标识管理、互联网诊疗合规（初诊必须线下面诊）、患者隐私 PIPL 合规（敏感个人信息须单独授权）、学术推广合规（医疗代表备案、会议赞助标准、医师讲课费规范）。关键原则：**合规不是"堵营销"，而是"保护品牌"**——一次违规处罚的代价远高于合规投入；**"事前审查"优于"事后补救"**——所有对外发布的医疗营销内容必须经过合规团队审核。成功指标：年度零监管处罚、平台违规 < 3次/年、100% 内容发布前合规审查覆盖率。属 The Agency Specialized 部门的合规垂直方向，与 [[government-digital-presales-consultant]]（政府合规）和 [[legal-compliance-checker]]（通用法律合规）共同构成完整的合规能力体系。 -**[[blockchain-security-auditor]]**（Blockchain Security Auditor）：The Agency Specialized 部门的智能合约安全审计 Agent——专职发现 DeFi 协议与区块链应用中的漏洞，核心理念：**在攻击者之前找到漏洞**。核心方法：自动化静态分析（Slither/Mythril/Echidna）+ 人工逐行审查 + 属性化模糊测试 + 经济博弈建模；五步工作流（范围→自动化分析→人工审查→经济分析→报告）。核心原则：自动化工具只能捕获约 30% 的真实漏洞；每个发现必须包含可复现 PoC；使用 OpenZeppelin 不等于安全（误用安全库本身是漏洞类型）；必须验证代码与部署字节码一致（供应链攻击真实存在）。漏洞评级严格化：能导致用户资金损失的发现不得降级为 Informational。与 [[Agents-Orchestrator]] 构成审计质量门控——流水线交付前须通过安全审计；与 [[compliance-auditor]] 同属审计类 Agent，但前者聚焦代码层智能合约安全，后者聚焦企业合规认证体系（SOC 2/ISO 27001/HIPAA）。 +**[[blockchain-security-auditor]]**（Blockchain Security Auditor）：The Agency Specialized 部门的智能合约安全审计 Agent——专职发现 DeFi 协议与区块链应用中的漏洞，在攻击者之前找到 bug。核心理念：**"Your job is not to make developers feel good — it is to find the bug before the attacker does."** 核心理念：自动化工具只能捕获约 30% 的真实漏洞；每个发现必须包含可复现 PoC；使用 OpenZeppelin 不等于安全（误用安全库本身是漏洞类型）；必须验证代码与部署字节码一致（供应链攻击真实存在）；Solidity 0.8+ 的 `unchecked` 块仍需审查；漏洞发现误报率必须控制在 10% 以下。核心方法：自动化静态分析（[[Slither]]/[[Mythril]]/[[Echidna]]）+ 人工逐行审查 + 属性化模糊测试 + 经济博弈建模；五步工作流（范围→自动化分析→人工审查→经济分析→报告）。交付物包含完整审计报告模板（Severity 分类表 + 详细 Finding 结构 + Foundry PoC）、Slither 综合分析脚本（高/中置信度分类）、访问控制审计清单（Role Hierarchy/Initialization/Upgrade Controls/External Calls）。高级能力涵盖形式化验证（[[Certora]]/[[Halmos]]/KEVM）、EVM 层漏洞（存储冲突/签名重放/跨链消息重放）、事件响应（攻击溯源 + 救援合约）。漏洞评级严格化：能导致用户资金损失的发现不得降级为 Informational；C-01/H-01 必须在部署前修复；Medium 可随监控计划上线。与 [[Agents-Orchestrator]] 构成审计质量门控——流水线交付前须通过安全审计；与 [[Compliance-Auditor]] 同属审计类 Agent，但前者聚焦代码层智能合约安全，后者聚焦企业合规认证框架。 **[[compliance-auditor]]**（Compliance Auditor）：The Agency Specialized 部门的专业技术合规审计 Agent——专注于 SOC 2、ISO 27001、HIPAA、PCI-DSS 等安全隐私认证的全流程指导，从准备评估到证据收集直至认证通过。与 Healthcare Marketing Compliance 侧重营销内容合规不同，Compliance Auditor 关注**技术控制体系**的审计准备。核心方法：五步工作流（Scoping → Gap Assessment → Remediation Support → Audit Support → Continuous Compliance）；核心原则：**不跟随的政策比没政策更危险**（Checkbox-Compliance 是反面教材）、**证据必须证明整个审计周期内持续有效**（而非仅当下存在）、**自动化证据收集从第一天建立**（手动流程无法扩展）、**技术控制优于管理控制**（代码比培训更可靠）。核心交付物：Gap Assessment Report（差距评估报告）、Evidence Collection Matrix（证据收集矩阵）、Policy Template（策略模板）。成功指标：零不合格发现（zero adverse findings）、审计周期缩短 30%、年度合规状态持续可查。与 [[specialized-model-qa]] 互补——后者审计 AI/ML 模型质量，前者审计组织整体安全控制，两者共同构成完整的技术合规审计体系；与 [[automation-governance-architect]] 协同——自动化证据收集需依托 Governance Architect 设计的 AI 系统治理框架。 -|**[[specialized-workflow-architect]]**（Workflow Architect）：工作流设计专家 Agent——The Agency Specialized 部门的工作流设计与系统建模专家，在代码编写前对系统所有路径进行穷举建模。核心职责：**工作流发现**（扫描 route/worker/migration/IaC/cron 文件找出隐式工作流）+ **工作流注册表维护**（四视角：按工作流/按组件/按用户旅程/按状态）。核心交付物：**工作流树规范格式**（含 Actor/Prerequisites/Trigger/Step 树/ABORT_CLEANUP/State Transitions/Cleanup Inventory/Test Cases/Assumptions），覆盖快乐路径+七类失败分支（输入验证/超时/瞬态/永久/部分失败/并发冲突）。关键原则：**不只为快乐路径设计**、**每个系统边界定义显式 Handoff Contract**（payload schema + 成功/失败响应 + 超时值 + 恢复动作）、**Reality Checker 验证是 Draft 升为 Approved 的前置条件**。Agent 协作协议：Reality Checker 验证规范→Backend Architect 实现代码→API Tester 生成测试用例→DevOps Automator 验证清理顺序。属 The Agency Specialized 部门的质量保障基础设施，与 [[specialized-civil-engineer]]（基础设施工程）同属 Specialized 专业 Agent 系列。 +|**[[specialized-workflow-architect]]**（Workflow Architect）：工作流设计专家 Agent——The Agency Specialized 部门的工作流设计与系统建模专家，在代码编写前对系统所有路径进行穷举建模。核心职责：**工作流发现**（扫描 route/worker/migration/IaC/cron/event-listener/webhook 文件找出隐式工作流）+ **工作流注册表维护**（四视角：按工作流/按组件/按用户旅程/按状态）。核心交付物：**工作流树规范格式**（含 Actor/Prerequisites/Trigger/Step 树/ABORT_CLEANUP/State Transitions/Cleanup Inventory/Test Cases/Assumptions），覆盖快乐路径+七类失败分支（输入验证/超时/瞬态/永久/部分失败/并发冲突）。关键原则：**不只为快乐路径设计**、**每个系统边界定义显式 Handoff Contract**（payload schema + 成功/失败响应 + 超时值 + 恢复动作）、**Reality Checker 验证是 Draft 升为 Approved 的前置条件**、**每个分支必须有对应测试用例**（无测试覆盖的分支在生产中断言）。Agent 协作协议：Reality Checker 验证规范→Backend Architect 实现代码→API Tester 生成测试用例→DevOps Automator 验证清理顺序→Security Engineer 审查凭证传递。高级能力：**好奇心驱动式 Bug 发现**（追问数据持久化假设/网络连通性假设/时序假设/认证假设，主动发现高危 Bug）。成功指标：假设表随时间持续缩减、注册表中无 Missing 状态工作流残留超过一个 Sprint、零孤岛资源。属 The Agency Specialized 部门的质量保障基础设施，与 [[specialized-civil-engineer]]（基础设施工程）同属 Specialized 专业 Agent 系列。 **[[corporate-training-designer]]**（Corporate Training Designer）：The Agency Specialized 部门的企业培训体系架构师与课程开发专家——专注企业级培训需求分析、ADDIE/SAM 教学设计模型、混合学习项目、内训师培养（TTT）、领导力发展（HIPO）及 Kirkpatrick 四级培训效果评估。核心价值观：**优秀培训的衡量标准不是"教了什么"，而是"学员回去做了什么"**。关键方法：ADDIE 模型（分析→设计→开发→实施→评估）、Bloom 认知六层次、Kirkpatrick 四级评估（反应→学习→行为→业务结果）、Kolb 体验式学习圈、OMO 混合学习（线上"认知"→线下"实践"→社群"持续"）。与 [[specialized-workflow-architect]]（工作流设计）和 [[cultural-intelligence-strategist]]（跨文化产品设计）形成系统性设计能力互补——分别应用于组织学习、软件工程和文化包容三大领域，共同构成 [[The Agency]] 的系统性设计矩阵。 @@ -987,33 +1046,38 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]] 核心交付物：DataManager.lua（含 retryAsync + deepCopy + 双保存点）、CombatSystem.lua（完整验证链路示例）、GameServer.bootstrap.server.lua（五阶段引导模式）。高级能力涵盖 Parallel Luau（task.desynchronize + Actor 模型 + SharedTable）、对象池（预实例化 effects/NPC 减少 GC）、数据版本迁移（data._version + UpdateAsync 原子升级）。属 The Agency Game Dev 部门 Roblox Studio 专项，与 [[Roblox Experience Designer]]（玩家参与度和变现系统设计）协同构成完整 Roblox 开发体系——Experience Designer 定义体验目标，Systems Scripter 实现底层架构支撑。与 [[Server-Authoritative Architecture]]（服务器权威模型）、[[DataStore Reliability]]（DataStore 可靠性模式）、[[ModuleScript Architecture]]（模块化架构）、[[Parallel Luau]]（并行 Luau）共享 Roblox 系统工程核心技术栈。 -**[[roblox-experience-designer]]**（Roblox Experience Designer）：Roblox 平台原生体验设计师 AI Agent——专注于 Roblox 受众（9-17岁）的参与度循环设计、变现系统与玩家留存。核心使命：设计让玩家返回、分享和投资的体验。核心方法：DataStore 驱动进度系统（玩家等级/道具/货币持久化，创造沉没成本）；Roblox 原生化变现（Game Pass 永久权益、Developer Product 消耗品、UGC 道具）；参与度阶梯（首次会话→每日返回→周留存，每层有清晰奖励闭环）；每日奖励系统（1-7天循环阶梯，驱动习惯性返回）；入职引导三阶段（0-60秒/5分钟/15分钟，最小化早期流失）。核心原则：**免费体验必须完整**——禁止 pay-to-win；**DataStore 安全优先**——进度丢失是永久流失的首因；**变现伦理**——禁止暗黑模式、人工稀缺、压力购买。成功指标：D1 留存 >30%、D7 >15%、MAU 月增长 >10%、转化率 >3%、零 Roblox 政策违规。核心交付物：PassManager.lua（Game Pass 集中管理模块）、DailyRewardSystem.lua（每日奖励系统）、Onboarding Flow Design Document（含 Drop-off Recovery Points）。属 The Agency Game Dev 部门 Roblox Studio 专项，与 [[Roblox Systems Scripter]]（底层系统架构）协同构成完整 Roblox 开发体系——Experience Designer 定义体验目标，Systems Scripter 实现底层架构支撑。与 [[Game Designer]]（通用游戏设计方法论）、[[Technical Artist]]（视觉质量）协同构成 Game Dev 完整设计支撑体系。与 [[EngagementLoop]]（参与度循环）、[[DailyRewardSystem]]（每日奖励）、[[DataStoreProgression]]（数据存储进度）、[[RobloxMonetization]]（Roblox 变现）共享 Roblox 原生设计核心技术栈。 +**[[roblox-experience-designer]]**（Roblox Experience Designer）：Roblox 平台原生体验设计师 AI Agent——专注于 Roblox 受众（9-17岁）的参与度循环设计、变现系统与玩家留存。核心使命：设计让玩家返回、分享和投资的体验。核心方法：DataStore 驱动进度系统（玩家等级/道具/货币持久化，创造沉没成本）；Roblox 原生化变现（Game Pass 永久权益、Developer Product 消耗品、UGC 道具）；参与度阶梯（首次会话→每日返回→周留存，每层有清晰奖励闭环）；每日奖励系统（1-7天循环阶梯，第7天含徽章奖励，驱动习惯性返回）；入职引导三阶段（0-60秒/5分钟/15分钟，含流失恢复策略：<2分钟流失=引导过慢/5-7分钟=奖励不够吸引/>15分钟=缺少返回钩子）。核心原则：**免费体验必须完整**——禁止 pay-to-win；**DataStore 安全优先**——进度丢失是永久流失的首因；**变现伦理**——禁止暗黑模式、人工稀缺、压力购买；**Roblox SEO 三要素**——标题/描述/缩略图与玩法设计同等重要。成功指标：D1 留存 >30%、D7 >15%、MAU 月增长 >10%、转化率 >3%、零 Roblox 政策违规。核心交付物：PassManager.lua（集中管理 VIP/DoubleXP/ExtraLives，ownershipCache 避免过度 API 调用）、DailyRewardSystem.lua（7天循环奖励阶梯，含 pcall 安全保存和断连恢复）、Onboarding Flow Design Document（含 Drop-off Recovery Points）、Retention Metrics Tracking（AnalyticsService 事件追踪：OnboardingCompleted/FirstPurchase/SessionEnd）。高级能力涵盖：**Live Ops 事件运营**（ReplicatedStorage 配置对象 + 服务器重启实现限时活动，无需热更新）；**高级分析**（A/B 测试基础设施 math.random() 按 UserId 分配桶、队列元数据存储 Cohort 分析、HttpService 导出至外部 BI）；**社会化系统**（好友邀请奖励 GetFriendsAsync 验证、Group 门控 GetRankInGroup、实时在线人数/成就展示 Lobby）；**变现优化**（软货币首次购买漏斗降低门槛、价格锚定高级选项对比、购买遗弃提醒通知）。属 The Agency Game Dev 部门 Roblox Studio 专项，与 [[Roblox Systems Scripter]]（底层系统架构）协同构成完整 Roblox 开发体系——Experience Designer 定义体验目标，Systems Scripter 实现底层架构支撑。与 [[Game Designer]]（通用游戏设计方法论）、[[Technical Artist]]（视觉质量）协同构成 Game Dev 完整设计支撑体系。与 [[EngagementLoop]]（参与度循环）、[[DailyRewardSystem]]（每日奖励）、[[DataStoreProgression]]（数据存储进度）、[[RobloxMonetization]]（Roblox 变现）共享 Roblox 原生设计核心技术栈。与 [[UnityArchitect]] 在变现策略上存在受众差异——Roblox 面向 9-17 岁强制伦理变现，Unity 平台受众更广可接受更强付费优势。 **[[roblox-avatar-creator]]**（Roblox Avatar Creator）：Roblox UGC 化身 pipeline 专家 AI Agent——掌握 Roblox avatar 系统的全部约束条件，以及如何构建能通过 Creator Marketplace 审核的商品。核心理念：技术规格精准、视觉打磨到位、平台合规。核心规范：UGC 网格三角面数硬限制（配件 ≤4,000、Bundle 部件 ≤10,000）；单 UV 通道且范围严格在 [0,1]；所有 transform 在导出前必须应用（scale=1, rotation=0）；纹理分辨率 256×256 ~ 1024×1024 PNG，UV island 留 2px 最小 padding；Layered Clothing 必须有 Outer Mesh + InnerCage + OuterCage 三层 cage。附件点必须使用标准命名（HatAttachment / FaceFrontAttachment / LeftShoulderAttachment 等），在 5 种 body type 上全部测试。核心交付物：Accessory Export Checklist（建模检查清单）、AvatarManager.lua（HumanoidDescription 全套换装）、Layered Clothing Cage Setup Guide（Blender cage 网格规范）、Creator Marketplace Submission Package（提交前审核检查清单）、UGC Shop UI Flow（MarketplaceService 购买监听）。属 The Agency Game Dev 部门 Roblox Studio 专项，与 [[Roblox Systems Scripter]]（Luau 系统架构）、[[Roblox Experience Designer]]（玩家变现）协同构成完整 Roblox 开发体系——Avatar Creator 负责 UGC 资产从建模到上线的 pipeline。与 [[LayeredClothing]]（分层服装系统）、[[HumanoidDescription]]（化身 API）、[[CreatorMarketplace]]（UGC 交易市场）、[[R15Rig]]（R15 骨骼权重系统）共享 Roblox 化身资产核心技术栈。与 [[UnityArchitect]] 在角色定制系统实现路径上存在平台差异——Roblox 强制服务端权威（HumanoidDescription + DataStore），Unity 可客户端预测，均为各自平台最优解。 **[[game-designer]]**（Game Designer Agent）：游戏系统与机制设计师 AI Agent——以"循环、杠杆、玩家动机"为思维框架，将创意愿景转化为可执行、无歧义的游戏设计文档（GDD）。核心理念：**从玩家动机出发设计，而非从功能列表出发**。核心方法：五步工作流（概念→设计支柱→纸面原型→GDD撰写→调优迭代）；三层核心循环（瞬间体验 0-30秒 → 会话目标 5-30分钟 → 长期进阶 数小时至数周）；数值以 `[PLACEHOLDER]` 标记假设直至测试验证。核心交付物：Game Design Document（含目的/玩家体验/输入/输出/边界/失败状态的完整机制规格）、Economy Balance Spreadsheet（玩家画像：鲸鱼/海豚/小鱼）、Player Onboarding Checklist（引导完成率目标 >90%）。高级能力涵盖行为经济学应用（Cialdini 影响原则/损失厌恶/变率奖励/沉没成本）、跨类型机制移植（机制活检分析）、高级经济设计（供给-需求模型/通胀检测/Monte Carlo 模拟）、系统性涌现设计（系统交互矩阵/最小可行复杂度）。属 The Agency Game Dev 部门。与 [[Narrative Designer]]（叙事-机制一致性整合）、[[Level Designer]]（关卡空间叙事协作）、[[Game Audio Engineer]]（反馈音效系统）、[[Technical Artist]]（视觉原型可执行化）共同构成 Game Dev 部门完整设计支撑体系。与 [[Core Gameplay Loop]]（核心循环设计）、[[Economy Balance]]（经济平衡）、[[Behavioral Economics in Games]]（行为经济学）共享 GameDesigner 核心方法论。 +**[[level-designer]]**（Level Designer Agent）：游戏关卡空间叙事设计师 AI Agent——将走廊视为句子、房间视为段落、关卡视为完整论点的空间叙事专家。核心理念：**空间本身就是叙事媒介**——玩家通过探索空间而非阅读文字来理解世界和感受情感。核心方法：六阶段工作流（意图定义→纸面布局→灰盒→遭遇战调优→美术交接→打磨）；节奏控制通过时间-张力图表（紧张→释放→探索→战斗交替）实现；遭遇战三要素（进入读时+多种战术选项+撤退位置）；环境叙事通过道具/光照/几何传达世界观无需对话。设计纪律：**灰盒阶段锁定设计决策，美术美化零例外必须先通过灰盒测试**；关键路径必须在视觉上可读（玩家迷路必须是刻意的设计而非系统失败）。高级能力涵盖空间心理学（Prospect-Refuge 理论使玩家感到安全）、程序化关卡设计（规则集+手工锚点保证生成质量下限）、Kevin Lynch 城市设计五要素应用于游戏空间、多人空间设计（视觉不对称性、观战清晰度）。核心交付物：Level Design Document（意图+节奏弧线+遭遇战列表）、Pacing Chart（时间-张力可视化）、Blockout Specification（含光照方向和覆盖率）、Navigation Affordance Checklist。属 The Agency Game Dev 部门。与 [[Game Designer]]（整体游戏设计框架）协作提供空间层落地；与 [[Narrative Designer]]（环境叙事内容架构）协同执行物理空间叙事；与 [[Technical Artist]] 在美术交接文档（gameplay-critical vs. dressable 标注）和 [[Game Audio Engineer]] 在节奏弧线音效支持上存在潜在冲突。与 [[Grey Box Blockout]]（灰盒）、[[Pacing Chart]]（节奏图表）、[[Encounter Design]]（遭遇战设计）、[[Environmental Storytelling]]（环境叙事）、[[Spatial Psychology]]（空间心理学）共享核心方法论工具集。 + **[[unreal-technical-artist]]**（Unreal Technical Artist）：Unreal Engine 5 视觉系统工程师 AI Agent——拥有 Material Editor、Niagara VFX、PCG 和 Nanite 全栈专业能力，负责 UE5 项目的美术-引擎视觉管线。核心交付标准：Material Function 库复用规范（消除跨 Master Material 重复节点簇）、Niagara Scalability 三档预设（High/Medium/Low）、确定性 PCG 图设计（相同参数→相同输出）、Nanite 优先策略（非适用资产须手动 LOD 链）、Substrate 多层材质（UE5.3+ 替代 SSS workaround）。性能纪律：每个 Static Switch 使着色器排列数翻倍，必须审计；所有粒子系统必须设 Max Particle Count；PCG 生成须在 3 秒内完成，流式加载不得造成卡顿。属 The Agency Game Dev 部门，与 [[Technical Artist]]（通用技术美术基类）共享 VFX/着色器核心规范；与 [[Unreal World Builder]]（开放世界场景搭建）、[[Unreal Systems Engineer]]（引擎底层系统）协同构成 UE5 专精团队。 **[[unreal-multiplayer-architect]]**（Unreal Multiplayer Architect）：Unreal Engine 5 多人游戏网络架构工程师 AI Agent——构建服务器权威模型、延迟容忍、作弊防护的生产级 UE5 多人游戏网络系统。核心理念：**服务器拥有真相，客户端请求——服务器决定**。核心方法：Server-authoritative 架构（所有游戏状态变化在服务器执行，客户端预测+对账）；UFUNCTION(Server, Reliable, WithValidation) 全覆盖（每个游戏逻辑 RPC 必须实现 _Validate）；复制频率按 Actor 类型差异化（投射物 100Hz/NPC 20Hz/环境物 2Hz）；GAS 双路径初始化（PossessedBy 服务器路径 + OnRep_PlayerState 客户端路径）。核心交付物：Replicated Actor 模板（含 RepNotify + WithValidation）、GameMode/GameState/PlayerState 架构规范、GAS 网络集成方案、Replication Graph 空间分区优化、专用服务器 Shipping 构建配置。性能指标：每玩家带宽 <15KB/s、反作弊验证全覆盖、200ms 延迟下每玩家每 30 秒校正 <1 次。属 The Agency Game Dev 部门，与 [[Unreal Technical Artist]]（UE5 视觉系统）、[[Game Designer]]（多人游戏机制设计）协同构成 UE5 专精团队。与 [[ServerAuthoritativeModel]]（服务器权威模型）、[[ActorReplication]]（Actor 复制）、[[GAS]]（Gameplay Ability System）、[[ReplicationGraph]]（复制图）共享 UE5 网络核心技术栈。 -**[[unreal-systems-engineer]]**（Unreal Systems Engineer）：Unreal Engine 5 系统架构工程师 AI Agent——掌握 C++/Blueprint 连续统一体、Nanite 几何系统、Lumen GI、Gameplay Ability System 的 AAA 级 UE5 项目性能与混合架构专家。核心理念：**Tick 逻辑必须 C++，Blueprint 是设计师 API 而非运行时引擎**。核心规范： +**[[unreal-systems-engineer]]**（Unreal Systems Engineer）：Unreal Engine 5 系统架构工程师 AI Agent——掌握 C++/Blueprint 连续统一体、Nanite 几何系统、Lumen GI、Gameplay Ability System 的 AAA 级 UE5 项目性能与混合架构专家。核心理念：**Tick 逻辑必须 C++，Blueprint 是设计师 API 而非运行时引擎；Blueprint Tick 较 C++ 存在 ~10x 性能差距，是规模级项目的性能隐患**。核心规范： -- **C++/Blueprint 边界**：每帧逻辑（Tick）必须 C++；Blueprint 适用于：高层游戏流、UI 原型、设计师可扩展层 -- **Nanite 预算**：单场景 1600 万实例上限，开放世界需提前规划实例预算；不兼容骨骼网格/复杂 clip 操作/样条网格 -- **内存安全**：所有 UObject 指针必须 UPROPERTY() 声明；跨帧 Actor 指针需 IsValid() 检查；TWeakObjectPtr/TSharedPtr 处理非拥有引用 -- **GAS 架构**：UGameplayAbility + UAttributeSet + UAbilitySystemComponent 网络就绪配置；FGameplayTag 替代字符串标识符 -- **高级能力**：Mass Entity（Unreal ECS，处理海量 NPC）、Chaos 破坏系统（Geometry Collection 实时断裂）、Lyra 模块化框架（GameFeatureAction 运行时注入） +- **C++/Blueprint 边界**：每帧逻辑（Tick）必须 C++，Blueprint VM 开销与缓存未命中在每帧调用频率下构成 ~10x 性能差距；Blueprint 适用于：高层游戏流、UI 原型、设计师可扩展层；Blueprint Callable/Native Event 暴露 C++ 接口给蓝图 +- **Nanite 预算**：单场景 1600 万实例上限，开放世界植被密度在 500m 视距内将超出上限；Nanite 隐式在像素着色器推导切线空间，**不得存储显式切线**；不兼容骨骼网格/复杂 clip 遮罩材质/样条网格/程序化网格组件；`r.Nanite.Visualize` 模式生产期早开早发现；Nanite 适用于：密集植被、模块化建筑套件、岩石地形细节 +- **内存安全**：所有 UObject 指针必须 UPROPERTY() 声明（缺失导致 GC 意外销毁）；跨帧 Actor 指针需 IsValid() 检查（不能用 != nullptr，对象可能处于 pending kill 状态）；TWeakObjectPtr/TSharedPtr/TWeakPtr 处理非拥有引用 +- **GAS 架构**：.Build.cs 须添加 "GameplayAbilities" + "GameplayTags" + "GameplayTasks"；UGameplayAbility + UAttributeSet（含 GAMEPLAYATTRIBUTE_REPNOTIFY）+ UAbilitySystemComponent 网络就绪配置；FGameplayTag 替代字符串（层级结构、复制安全、可搜索）；禁止手动复制技能状态，统一经由 UAbilitySystemComponent +- **Unreal Build System**：修改 .Build.cs 或 .uproject 后必须运行 GenerateProjectFiles.bat；模块依赖必须显式声明（循环依赖导致链接失败）；UCLASS/USTRUCT/UENUM 反射宏缺失导致**静默运行时失败**（非编译错误） +- **高级能力**：Mass Entity（Unreal ECS，FMassFragment 数据层 + FMassTag 标记 + UMassRepresentationSubsystem LOD 切换渲染）；Chaos 破坏系统（Geometry Collection 实时断裂 + Chaos constraint 类型 + Unreal Insights Chaos trace 通道分析）；Lyra 模块化框架（GameFeatureAction 运行时注入 + Experience-based 游戏模式切换 + HeroComponent 组件注入） 属 The Agency Game Dev 部门，与 [[Unreal Technical Artist]]（Nanite 资产验证与优化）协同处理几何管线；与 [[Unreal Multiplayer Architect]]（GAS 网络复制安全）在技能系统实现与 RPC 层调用上互补。核心性能纪律：Tick 逻辑 C++ 实现、帧预算 60fps（目标硬件）、Unreal Insights 性能分析验证。 **[[unreal-world-builder]]**（Unreal World Builder）：Unreal Engine 5 开放世界环境架构工程师 AI Agent——专注于 World Partition 分区流送、Landscape 地形系统、PCG 程序化内容生成和 HLOD 层级 LOD 构建，覆盖 4km² ~ 64km² 超大规模开放世界。核心理念：**用格子大小控制流送预算，用 RVT 消除地形层混合成本**。核心规范： - **World Partition 格子策略**：密集城区 64m / 空旷地形 128m / 沙漠海洋 256m+；Always Loaded 层存放 Sky/Audio/GameMode；关键游戏内容（任务触发器、关键 NPC）禁止放在格子边界 -- **Landscape 层限制**：单区域最多 4 层材质，超过则产生材质排列组合爆炸；超过 2 层必须启用 RVT（Runtime Virtual Texturing）消除逐像素层混合开销 -- **HLOD 规则**：所有 500m 以外可见区域必须生成 HLOD；Nanite 资产排除在 HLOD 合并之外；骨骼网格不支持 HLOD -- **PCG vs Foliage Tool**：Foliage Tool 仅用于手工放置主角物件；大规模植被用 PCG + Nanite 预烘焙；排除区域（道路/路径/水体/建筑）必须在 PCG 图中显式定义 -- **LWC（大世界坐标）**：任何轴超过 2km 的世界必须启用 LWC；约 20km 后无 LWC 会出现浮点精度错误；代码中位置使用 FVector3d 双精度 +- **Landscape 层限制**：单区域最多 4 层材质，超过则产生材质排列组合爆炸；超过 2 层必须启用 RVT（Runtime Virtual Texturing）消除逐像素层混合开销；景观空洞使用 Visibility Layer，禁止删除组件（会破坏 LOD 和水体系统集成） +- **HLOD 规则**：所有 500m 以外可见区域必须生成 HLOD；Nanite 资产排除在 HLOD 合并之外；骨骼网格不支持 HLOD；使用 Mesh Merge 方法，目标 LOD Screen Size ≤ 0.01 +- **PCG vs Foliage Tool**：Foliage Tool 仅用于手工放置主角物件；大规模植被用 PCG + Nanite 预烘焙；排除区域（道路/路径/水体/建筑）必须在 PCG 图中显式定义；Runtime PCG 仅限 < 1km² 小区域 +- **LWC（大世界坐标）**：任何轴超过 2km 的世界必须启用 LWC；约 20km 后无 LWC 会出现浮点精度错误；代码中位置使用 FVector3d 双精度；着色器中使用 `LWCToFloat()` 替代直接世界位置采样 +- **OFPA（One File Per Actor）**：所有 World Partition 关卡启用 OFPA 以支持多用户编辑；教育团队按 Actor 单独签出而非整个关卡文件；监控 OFPA 文件数增长并建立文件数预算 +- **流式性能优化**：使用 Unreal Insights 验证地面疾跑无 >16ms 卡顿；建立流式预算仪表盘（活动单元格数/每格内存/最大流式半径投影内存）；目标存储 I/O 延迟设计单元格大小（SSD vs HDD 相差 10-100x） 属 The Agency Game Dev 部门，与 [[Unreal Systems Engineer]]（Nanite 实例预算规划）共享 World Partition 流送基础设施；与 [[Unreal Technical Artist]]（Landscape 材质与 RVT 配置）共享地形渲染技术；与 [[Unreal Multiplayer Architect]]（World Partition 流送源与网络同步）互补。核心成功指标：地面疾跑无 >16ms 流送卡顿、1km² 以上区域全部预烘焙、HLOD 覆盖所有 500m+ 区域、Landscape 层数永不超 4。 @@ -1024,7 +1088,7 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]] - **PropertyDrawer 标准**：`OnGUI` 必须调用 `BeginProperty`/`EndProperty` 以正确支持 Prefab Override UI；`GetPropertyHeight` 返回值必须与 `OnGUI` 实际绘制高度一致 - **构建验证**：失败时必须抛出 `BuildFailedException`，而非仅 `Debug.LogWarning` -属 The Agency Game Dev 部门，与 [[technical-artist]]（编辑器工具和资产管线）共享工具开发模式；与 [[unreal-systems-engineer]] 在"构建前验证"模式上互补——Unity 侧通过 `IPreprocessBuildWithReport` 在打包前验证，Unreal 侧通过 UAssetCheckConfig 在编辑器内实时检查。核心成功指标：每项工具都有量化的"每周节省 X 分钟"指标；AssetPostprocessor 拦截所有应被捕获的违规资产；团队在发布后 2 周内自愿采用工具（无需提醒）。 +属 The Agency Game Dev 部门，与 [[technical-artist]]（编辑器工具和资产管线）共享工具开发模式；与 [[unreal-systems-engineer]] 在"构建前验证"模式上互补——Unity 侧通过 `IPreprocessBuildWithReport` 在打包前验证，Unreal 侧通过 UAssetCheckConfig 在编辑器内实时检查。核心交付物：AssetAuditWindow（纹理预算审计窗口）、TextureImportEnforcer（命名规范强制 `_N`→Normal Map + 预算强制 2048px + UI 贴图自动优化）、FloatRangeDrawer（MinMax 范围滑动条）、BuildValidationProcessor（构建前质量门控）。高级能力涵盖：Assembly Definition 架构（asmdef 隔离编辑器/运行时程序集 + 追踪编译时间）、CI/CD 集成（`-batchmode` 头less 验证 + AssetPostprocessor CI 审计 CSV 输出）、Scriptable Build Pipeline（自定义构建任务：资产剥离/着色器变体收集/CDN 缓存失效 + 分平台 Addressable Bundle）、UI Toolkit 迁移（从 IMGUI EditorWindow 迁移到 UIElements + USS 暗/亮主题支持 + 数据绑定 API）。核心成功指标：每项工具都有量化的"每周节省 X 分钟"指标；AssetPostprocessor 拦截所有应被捕获的违规资产；团队在发布后 2 周内自愿采用工具（无需提醒）。 **[[unity-shader-graph-artist]]**（Unity Shader Graph Artist）：Unity 渲染效果专家 AI Agent——精通 Shader Graph 可视化材质创作与 HLSL 性能优化，专注于 URP/HDRP 渲染管线的实时视觉效果开发。核心理念：**Shader Graph 是艺术家创作的首选工具，HLSL 仅用于性能关键路径**。核心规范： @@ -1123,4 +1187,21 @@ Key concepts: [[Django ORM]], [[Django REST Framework]], [[Django Admin 定制]] 23. **本地 Ollama + Qwen2.5-Coder 部署：开发者本地 AI Coding 基础设施**：[[在-ubuntu-安装-ollama-并运行-qwen2-5‑coder-7b]] 介绍了在 Ubuntu 上通过 Ollama 本地部署 Qwen2.5-Coder 7B 的完整流程。核心价值：3 条命令完成安装（`curl install.sh | sh` → `ollama pull qwen2.5-coder:7b` → `ollama run qwen2.5-coder:7b`），模型约 4.5GB，最低 8GB RAM 推荐 16GB，无需 GPU 也可运行。推荐搭配工具链：Open WebUI（ChatGPT 风格 UI）、n8n（AI 工作流自动化）、LangChain（Agent 框架）、OpenClaw（AI Coding Agent）。[[Qwen2.5-Coder]] 相比普通 `qwen2.5:7b` 在 Tool usage、Shell/Python/SQL 理解和 Repo 级代码理解方面更强，更适合 DevOps automation、SQL Agent、Kubernetes troubleshooting 等工程任务。Ollama 默认仅监听 127.0.0.1，通过设置 `OLLAMA_HOST=0.0.0.0` 可开放远程 API 访问，支持 Python/NodeJS SDK 和 n8n、WebUI、Agent 等外部调用。属 [[AI时代发展策略]] 的本地 AI 基础设施层。 +24. **Senior Project Manager Agent：规格驱动型任务规划 Agent**：[[project-manager-senior]] 定义了一种专注于将站点规格说明转换为可执行开发任务清单的 AI Agent。其核心工作流：读取 `ai/memory-bank/site-setup.md` → 引用精确需求原文（不自行发挥）→ 拆解为 30-60 分钟原子任务 → 每个任务附带验收标准。与 [[project-management-studio-producer]]（工作室生产管理）、[[project-management-project-shepherd]]（项目全程跟踪）、[[project-management-jira-workflow-steward]]（Jira 工作流维护）共同构成项目管理层 Agent 矩阵。核心设计理念：**规格比表面看起来更简单**，任务粒度控制在可执行单元，强调基础实现优于奢华功能，预留 2-3 轮迭代周期。技术栈锁定 Laravel/Livewire + FluxUI + Playwright QA。 + +25. **ZK Steward Agent：Luhmann Zettelkasten 的 AI Agent 实现**：[[zk-steward]] 将 Niklas Luhmann 的卡片盒笔记法（Zettelkasten）引入 AI Agent，用于构建有链接、可验证、持续生长的知识网络。核心机制：① **Luhmann 四原则验证**（原子性 / 连通性 / 有机增长 / 持续对话）——每条笔记归档前必须通过四问；② **领域专家切换**（Luhmann 默认 / Feynman 学 / Munger 策略 / Ogilvy 品牌 / Karpathy 工程 / Mollick prompting 等）——按"领域 × 任务类型 × 输出形式"三角定位选取最匹配的专家心智模型；③ **任务闭环清单**（四原则验证 / 归档路径与 ≥2 链接 / 每日日志 / 开放循环清理 / 链接提案 + Gegenrede 反问）。核心价值：**结构优先、连接至上、验证驱动**——每一回复声明专家视角、每笔记通过 Luhmann 四原则、每个知识单元嵌入网络而非孤立存在。[[zk-steward-companion]] 提供配套的 Cursor/Claude Code 兼容 Skill 定义。与 [[Zettelkasten]]（方法论根源）、[[Second Brain]]（持久化笔记系统）共同构成知识管理工具矩阵。 + +26. **Report Distribution Agent：销售报告自动化分发 Agent**：[[report-distribution-agent]] 自动化分发整合后的销售报告给对应业务员，基于区域（Territory）路由规则确保每个业务员只收到其负责区域的数据。核心能力：①**Territory-Based Routing**——业务员按 Assigned Territory 接收对应区域报告；②**Schedule Distribution**——每日报告（工作日早8点）和每周汇总（周一早7点）自动发送；③**Audit Trail**——每次分发均记录收件人、区域、状态、时间戳，支持合规查询；④**Graceful Failure**——分发失败时记录错误并继续向其他收件人发送，绝不静默丢弃；⑤**Report Formats**——HTML 格式区域报告含业务员绩效表，公司汇总含区域对比表，遵循 STGCRM 品牌规范。与 [[Data Consolidation Agent]] 协作生成报告内容，共同构成销售团队报告自动化体系。 + +27. **Automation Governance Architect：治理优先的自动化决策框架**：[[automation-governance-architect]] 是 n8n-first 的业务自动化治理架构师，核心理念：**治理优于自动化数量**——不是所有技术可行的自动化都值得做，必须通过四维评估框架（时间节省 / 数据关键性 / 外部依赖风险 / 可扩展性）才能进入生产。核心产出：五级裁定结果（APPROVE / APPROVE AS PILOT / PARTIAL AUTOMATION ONLY / DEFER / REJECT）、n8n 工作流十步标准（Trigger → Validation → Logic → Actions → Logging → Error Branch → Fallback → Writeback）、可靠性基线（幂等/重试/超时/告警/人工fallback）、测试基线（6类测试覆盖）和集成治理规范（每个集成必须明确 Source of Truth）。与 [[Workflow-Architect-Agent-Personality]] 存在互补张力：后者负责"如何构建"，前者负责"是否值得构建"——建议 Workflow Architect 在构建前先过治理评估。属 The Agency Specialized 部门的治理支柱，为自动化建设提供护栏保障。 + +28. **Marketing Reddit Community Builder：价值优先的 Reddit 社区营销 Agent**：[[marketing-reddit-community-builder]] 定义了一种与传统营销截然不同的 Reddit 参与策略——**不是"在 Reddit 上营销"，而是"成为有价值贡献的社区成员，恰好代表某个品牌"**。核心机制：① **90/10 法则**——90% 价值内容，10% 推广内容，确保不被视为垃圾信息；② **四阶段工作流**——社区研究与融入 → 内容策略制定 → 声誉建立 → 战略价值创造；③ **Karma 系统**——通过持续提供价值积累社区声望（目标 10,000+ karma），每条帮助性评论平均 5+ upvotes。成功指标：5+ 相关子版块获得可信贡献者身份、AMA 协调实现 500+ 问答互动、品牌相关讨论正面情感达 80%+。核心矛盾：与即时转化导向的社交媒体营销思维冲突——Reddit 营销以季度/年为周期建立关系，追求长期信任而非短期 ROI。与 [[Marketing Social Media Strategist]] 共享社区运营方法论，但 Reddit 独特的文化（子版块规则、反spam机制、社区规范）需要专门的参与策略。 + +29. **Marketing Kuaishou Strategist：快手下沉市场直播电商专家 Agent**：[[marketing-kuaishou-strategist]] 定义了一种专注于快手平台短视频营销与直播电商运营的 Agent。核心理念：**真实性 > 精致度**——快手用户能即时识别并排斥虚伪内容，生产真实场景下的产品演示比精致工作室拍摄更有价值。核心差异于抖音：快手"均衡分发"算法给予每个创作者基础曝光（日更一致性 > 单次爆款）；下沉市场（30-50岁，三四五线城市）为核心受众；老铁（兄弟）关系驱动重复购买而非冲动发现购买；信任建立后再商业转化。与 [[营销抖音策略]]（抖音中心化推荐 + 一二线城市 + 精致内容）共同构成中国短视频营销双平台差异化策略体系。关键方法论：3-2-1 话术框架（3个痛点 → 2个演示 → 1个不可抗拒的offer）、直播前中后完整 playbook、私域运营（粉丝团 + 微信）提升 LTV。成功指标：直播转化率 ≥3%、平均观看时长 ≥5 分钟、粉丝团月增长 ≥15%、老铁自发在评论区为品牌辩护（终极信任信号）。 + +30. **WeChat Mini Program Developer Agent：微信小程序全栈开发 Agent**：[[engineering-wechat-mini-program-developer]] 定义了一种专注于微信生态高性能小程序开发的 AI Agent，核心约束来自微信平台独特的技术限制：双线程架构（无 DOM 操作、setData 跨线程通信）、包体积限制（主包 ≤2MB，子包合计 ≤20MB）、域名白名单 + HTTPS 强制要求。核心方法论：WXML/WXSS/WXS 技术栈、组件化 + 子包加载策略、微信支付四步流程（服务端创建订单 → 小程序 wx.requestPayment → 回调处理）、订阅消息替代已废弃模板消息（关键节点触发授权）。跨平台能力：Taro（React）和 uni-app（Vue）实现一次开发多端部署（微信/支付宝/百度/抖音）。性能指标：启动时间 <1.5秒、主包 <1.5MB、审核首次通过率 >90%、WeChat DevTools 性能评分 >90/100。与 [[engineering-mobile-app-builder]] 共享移动应用开发方法论，差异在于微信生态的特殊平台约束（审核政策、包体积限制、双线程架构）。 + +31. **Email Intelligence Engineer Agent：邮件数据管道与 AI 推理上下文工程 Agent**：[[engineering-email-intelligence-engineer]] 定义了一种将原始邮件（MIME/Gmail API/Microsoft Graph）转换为 AI Agent 可消费的结构化推理上下文的专用 Agent。核心洞察：邮件的结构复杂性（引用文本重复、转发链折叠、线程分叉、第一人称代词歧义）导致传统 RAG 方式无法正确理解邮件对话，必须保留线程拓扑才能正确归因和推理。核心四步管道：①邮件摄取与标准化（RFC 5322/MIME 解析、字符编码归一化）→ ②线程重建与去重（In-Reply-To/References 头链重建对话图、引用文本去重 4-5x 压缩）→ ③结构化分析（参与者检测与角色推断、决策时间线、行动项归因、沉默决策检测）→ ④上下文组装与工具接口（混合检索：语义+全文+元数据过滤器、Token 预算管理、带来源引用的结构化 JSON 输出）。关键质量指标：线程重建准确率 >95%、引用内容去重率 >80%、行动项归因准确率 >90%、Agent 下游任务准确率提升 >20%。LangChain / CrewAI / LlamaIndex / MCP Server 是核心集成目标，使邮件智能能力可直接被主流 Agent 框架消费。属 The Agency Engineering 部门的数据管道专精层，与 [[engineering-backend-architect]] 在数据管道架构上有协同空间，与 [[RAG]] 通用实现的核心张力在于：传统 RAG 将文档视为原子单元，而邮件是对话序列必须保留线程拓扑。属 [[Multi-Agent-AI-Systems]] 的数据输入层，为 Agent 系统提供邮件领域的推理上下文。 + +32. **Feishu Integration Developer Agent：飞书开放平台全栈集成专家 Agent**：[[engineering-feishu-integration-developer]] 定义了一种专注于飞书（Feishu/Lark）开放平台企业级集成的 AI Agent，覆盖自定义机器人、交互式消息卡片、审批流自动化、Bitable 多维表格、SSO/OIDC 认证和飞书小程序六大核心模块。核心理念：**飞书集成不只是调用 API**，必须处理权限模型、事件幂等性、多租户架构和与内部系统的深度集成。核心工程标准：`tenant_access_token`（应用级）与 `user_access_token`（用户级 OAuth）必须严格区分使用场景；所有 API 响应必须检查 `code` 字段；事件处理必须实现幂等性（飞书可能重复投递同一事件）；卡片 JSON 必须在 Card Builder 工具验证后才发送；Bitable 批量写入每请求上限 500 条需分批并建议批次间 200ms 延迟。核心交付物：完整项目结构（config/auth/bot/approval/bitable/sso/webhook 目录）、TokenManager 缓存实现（含提前5分钟刷新边界保护）、CardBuilder 审批通知卡片（含 Approve/Reject/View Details 三按钮）、EventDispatcher 事件分发（含 Bot 消息接收和审批状态变更监听）、BitableClient CRUD（含 500 条分批写入）、OAuth 授权登录三步流程（authorize 重定向 → code 交换 → user_info 获取，state 参数防 CSRF）。成功指标：API 调用成功率 >99.5%、事件处理延迟 <2 秒、卡片渲染成功率 100%、Token 缓存命中率 >95%、审批流端到端时间缩短 50%+。属 The Agency Engineering 部门的集成专精层，与 [[engineering-backend-architect]] 在 API 集成架构上有协同空间；与 [[engineering-rapid-prototyper]] 在速度哲学上存在张力：原型阶段可简化幂等性和错误处理，生产化阶段必须补充完整错误恢复机制。 diff --git a/wiki/sources/engineering-cms-developer.md b/wiki/sources/engineering-cms-developer.md new file mode 100644 index 00000000..6afbd475 --- /dev/null +++ b/wiki/sources/engineering-cms-developer.md @@ -0,0 +1,56 @@ +--- +title: "CMS Developer Agent Personality" +type: source +tags: [] +date: 2026-05-01 +--- + +## Source File +- [[Agent/agency-agents/engineering/engineering-cms-developer.md]] + +## Summary（用中文描述） +- 核心主题：CMS Developer Agent 个性定义——专注于 Drupal 和 WordPress 网站开发的专业 Agent +- 问题域：企业级 CMS 主题开发、自定义插件/模块开发、内容架构设计、代码优先（code-first）CMS 实现 +- 方法/机制：通过 ContentModel-first 工作流 + WordPress/Drupal 双平台技术栈 + Code over configuration UI 原则，提供生产级 CMS 交付物 +- 结论/价值：让编辑爱用、开发者可维护、基础设施可扩展的 CMS 实现专家 Agent + +## Key Claims（用中文描述） +- CMS Developer Agent：Drupal 和 WordPress 全栈开发专家 Agent，可交付从内容建模到上线审计的完整 CMS 开发生命周期 +- ContentModel-first 原则：在编写任何主题代码前，必须先锁定字段、内容类型和编辑工作流 +- Code over configuration UI：自定义帖子类型、分类、字段、代码块均通过代码注册，绝不依赖后台 UI +- Never fight the CMS：使用 hooks/filters/plugin 系统，绝不 monkey-patch 核心代码 +- Configuration as code：Drupal 配置导出为 YAML；WordPress 配置写入 wp-config.php 或代码，不存入数据库 +- Child themes only：永远不直接修改 parent theme 或 contrib theme +- Accessibility non-negotiable：所有交付物必须满足 WCAG 2.1 AA 标准 + +## Key Quotes +> "A CMS isn't a constraint — it's a contract with your content editors. My job is to make that contract elegant, extensible, and impossible to break." — CMS Developer Agent 核心理念 + +## Key Concepts +- **ContentModel-first**：先确认字段、内容类型、编辑工作流，再编写主题代码的开发原则 +- **CodeOverConfiguration**：所有内容类型、分类法、字段、代码块均通过代码注册，不依赖后台 UI +- **GutenbergBlockEditor**：WordPress 5.0+ 的块编辑器系统，支持通过 block.json + JS + PHP render 构建自定义块 +- **LayoutBuilder**：Drupal 的可视化布局构建器，支持 per-node 布局、布局模板、自定义 section/component 类型 +- **TwigTemplating**：Drupal 的 PHP 模板引擎，配合 preprocess hooks 提供灵活的数据处理能力 +- **ACFPro**：WordPress 高级自定义字段插件，支持灵活内容（Flexible Content）和 ACF Blocks +- **ComposerWorkflow**：Drupal 的依赖管理和包工作流，包括 patches、版本锁定、安全更新 +- **WCAGCompliance**：网页内容无障碍指南 2.1 AA 级标准 + +## Key Entities +- **WordPress**：开源 CMS 平台，擅长编辑简单性、WooCommerce 电商、广泛插件生态 +- **Drupal**：开源 CMS 平台，擅长复杂内容模型、企业级、多语言场景 +- **Gutenberg**：WordPress 5.0+ 内置的块编辑器系统 +- **ACF（Advanced Custom Fields）**：WordPress 字段管理插件（Pro 版支持 ACF Blocks） +- **Paragraphs + Layout Builder**：Drupal 的灵活内容构建方案 + +## Connections +- [[ContentModel-first]] ← foundational ← [[GutenbergBlockEditor]] / [[LayoutBuilder]] / [[TwigTemplating]] +- [[CodeOverConfiguration]] ← implements ← [[WordPress]] / [[Drupal]] custom development +- [[CMSDeveloper]] ← extends ← [[BackendArchitect]]（内容架构与 API 设计层面） +- [[CMSDeveloper]] ← complements ← [[SoftwareArchitect]]（系统架构层面） +- [[WCAGCompliance]] ← required_by ← all CMS deliverables +- [[WordPress]] ← used_for ← brochure_sites / WooCommerce / headless_WP +- [[Drupal]] ← used_for ← enterprise_platforms / complex_content_models / multilingual_sites + +## Contradictions +- 无已知内容冲突