project-wiki-manager

项目 Wiki 管理器

此技能是 UI/UX Agent 技能系统的项目记忆协调器。它负责决定应记录哪些内容、哪些内容必须排除、应调用哪个 Wiki 后端技能，以及下游 Agent 应如何使用生成的上下文。

运行模式

• init：在大型项目启动前创建项目记忆计划和必需的 Wiki 产物映射。
• capture：在重大决策或交付步骤后，记录经过脱敏的决策、产物、约束和阻碍因素。
• context-pack：为下一个 Agent 或未来的会话准备精简的上下文包。
• sync：在任务计划、设计、SEO、Figma 或发布发生变更后，更新现有 Wiki 页面。
• audit：检查项目记忆是否已过时、包含秘密信息、存在重复内容，或遗漏重要决策。
• handoff：生成最终的脱敏交接内容，其中包含准确的产物路径和后续负责人。

必需工作流

1. 判断项目规模：
   • small：单个局部任务；Wiki 记录可选。
   • medium：涉及多个文件、一个工作流或一个设计方向；仅记录重大决策。
   • large：涉及多次会话、多项技能、SEO/UI/Figma/Stitch/基础设施、迁移或发布工作；必须通过 Wiki 门控。
2. 阅读 references/wiki-gate-contract.md。
3. 写入或导入任何产物前，阅读 references/sanitization-policy.md。
4. 如需创建新的项目记忆映射，请使用 assets/project-memory-map.template.md。
5. 选择后端：
   • wiki-capture 用于记录当前对话中的决策。
   • obsidian-wiki-ingest / wiki-ingest 用于导入现有文档和报告。
   • wiki-context-pack 用于为下一个 Agent 准备精简的上下文片段。
   • wiki-query 用于根据已存储的项目知识回答问题。
6. 记录准确的源产物路径、决策日期、负责人角色、证据状态以及排除的敏感数据。
7. 除非用户明确批准存储特定内容，否则绝不存储秘密信息、令牌、Cookie、.env 值、恢复代码、私人截图或私人 URL。

记录触发条件

满足以下任一条件时，必须通过 Wiki 门控：

• 项目使用了 senior-ui-ux-orchestrator 和两项或更多专业技能。
• 已接受三方案设计、评审团决策、迁移、Figma 交接、Stitch 输出审核、发布计划或上线发布。
• 进度屏幕上的用户门控记录了已接受的设计选择、批准、阻碍解决方案或发布确认，且未来的 Agent 必须记住这些内容。
• 项目跨越多次会话，或 TASK-PLAN 中包含未完成任务。
• 未来的 Agent 需要当前文件树中无法明显看出的上下文。
• 用户明确要求保留上下文。

对于微小的一次性编辑、临时实验或包含未脱敏秘密信息的产物，可跳过或延后记录。

产物约定

仅记录长期有效的事实：

• 项目目标和受众；
• 已接受和已拒绝的决策；
• 源文档和准确的产物路径；
• UX/SEO/Figma/Stitch/实现约束；
• 经过脱敏的进度屏幕决策、用户门控和已接受评论；
• 验证证据和跳过的检查；
• 未解决的阻碍因素和后续负责人；
• 已批准的下游 Agent 上下文包。

请勿记录：

• 原始令牌、密码、恢复代码、会话 Cookie、私钥、.env 值；
• 未经明确批准存储的私人 URL 或截图；
• 未经验证的事实性主张；
• 应保留在原始产物中的大段重复源文本。

报告格式

Wiki mode:
Project scale:
Source artifacts:
Backend skill/tool:
Captured facts:
Excluded sensitive data:
Context pack path:
Updated wiki pages:
Checks run:
Next owner:

验证

编辑此技能时，运行：

python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/project-wiki-manager
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/project-wiki-manager