project-workflowlisted

# Project Workflow ## 建立项目事实 1. 读取 [AGENTS.md](../../../AGENTS.md)、[项目画像](../../../docs/PROJECT_PROFILE.md) 和 [组件目录](../../../docs/rules/AI_COMPONENT_CATALOG.md)；画像维护按 `$project-profile profile` → `$project-profile components` 顺序执行。 2. 检查本次需求、最近实现、邻近测试、配置和已有组件，再决定改动。 3. 读取 [任务路由](references/task-routing.md)，选择能完成任务的最小 Skill、插件和工具组合。 4. 任务需要外部能力时，读取 [能力清单](../../../docs/capabilities.md)，核对插件、宿主能力和独立 Skill；未安装时按授权边界安装或报告缺失。 5. 只在触发条件适用时加载详细文档： - 通用复杂任务：[任务合同](../../../docs/rules/AI_TASK_CONTRACT.md)。 - 改动落在页面或视图组件文件（`.vue`/`.tsx`/`.jsx` 等）：[前端任务规范](../../../docs/rules/AI_FRONTEND_TASK.md) 和 [组件目录](../../../docs/rules/AI_COMPONENT_CATALOG.md)。 - 接口、身份、权限、数据、AI 责任或安全：[项目研发规范](../../../docs/rules/AI_PROJECT_STANDARDS.md)。 - 提示词、Skill、路由或代理工作流：[工作流原则](../../../docs/rules/AI_WORKFLOW_PRINCIPLES.md)。 6. 分别声明业务、视觉和工程事实源。外部输出只能补充，不能覆盖项目事实。 7. 若项目画像仍有影响本次任务的占位符，只输出参数化计划、信息缺口和继续条件，不进入具体文件设计或实现；用户明确选择继续时，可进行不依赖缺口的低风险工作。 ## 执行聚焦改动 - 保持范围聚焦，保留工作区现有修改，不执行破坏性操作。 - 优先复用项目画像声明的基础设施、组件、请求层、Schema、主题和国际化方案。 - 新规则、可复用组件和缺陷执行 RED → GREEN → REFACTOR；采用能通过验证的最小实现。 - 在系统边界校验输入，处理错误，不硬编码秘密，不静默吞异常或伪造成功。 - 共享组件不承载业务状态机、角色、权限或接口调用。 - 不手工修改生成目录，不为单次需求创建重复基础设施。 - 未获授权时，不执行外部写入、删除、发布、通知��生产数据操作。 ## 验证并闭环 1. 运行最窄的相关测试，再运行项目画像中的总质量门禁。 2. 提示词或 Skill 变更运行 `node .toolkit/scripts/check-ai-guidance.mjs --root .` 和当前宿主的 Skill 校验器。 3. 可见 UI 按项目画像实际打开每个目标路由，验证视口、主题、交互、键盘、焦点、溢出、可访问性和控制台。 4. 接口 UI 在非生产环境使用安全测试数据，从真实 UI 验证适用主流程、失败、权限和刷新持久化。 5. 审查最终变更，检查回归、秘密、无关修改、重复基础设施和生成文件。 6. 使用 [验收证据模板](../../../doc