AIASys

AIASys 项目专属前端架构与实现约束。用于在 AIASys 仓库中开发前端代码时，明确当前系统真实骨架与通用最佳实践之间的取舍关系。涵盖目录结构、路由方式、状态管理、API 层、组件分层等关键决策。始终在通用 skill 之前读取，确保实现服从项目现状。

AIASys 仓库项目结构与辅助产物管理规范。约束 scripts/、docs/、AIASys-design-draft/、apps/*/scripts/ 等目录的落位原则， 以及临时脚本、工具脚本、测试辅助脚本的生命周期管理。

React 19 前端开发模式规范。当需要创建 React 组件、实现页面、处理状态管理或处理异步操作与竞态条件时触发。 适用于 React 19 模式、Tailwind CSS 4 使用、shadcn/ui 集成、并发保护。 不适用于非 React 框架（如 Vue、Angular）、纯 CSS/HTML 页面、与 AIASys 设计系统无关的独立组件开发。

Execute development tasks following the SOP 5-Step workflow (Requirement → Architecture → Implementation → Verification → Delivery). Use this skill for all development tasks to ensure quality and traceability. This skill enforces stage gates, deliverables, and Definition of Done (DoD). Always use this skill when the user asks you to implement a feature, fix a bug, or refactor code, especially when they mention SOP or stage gates.

当 AI 或成员需要向 AIASys 或其他开源项目提交 Issue、认领 Issue、提交 PR 时使用。 触发于"提 issue""认领 issue""提 PR""给开源项目反馈 bug""fork 项目""贡献代码" "open source contribution""向上游提交"等场景。 适用于 GitHub 开源项目的 Issue 报告、Issue 认领、PR 提交、Code Review 参与。 不适用于项目内部的纯 Git 操作（用 aiasys-git-workflow）或不涉及上游提交的代码审查。

AIASys 项目专属 Git 工作流。当在 AIASys 项目中执行 git commit、创建分支、 准备 PR、审计 worktree、整理提交历史时触发。 适用于 AIASys 仓库内的版本控制规范，不适用于其他项目或个人仓库。

AIASys 系统专属设计约束。用于在 AIASys 内进行前端界面设计、任务语义收口、设置与工作区信息架构设计，以及后端能力模型、配置模型和作用域分层设计时，确保输出优先服从 AIASys 当前系统边界，而不是套用通用最佳实践。

团队 Skill 使用指南（团队版）。当 AI 首次进入本项目、需要了解有哪些 Skill、 不知道某个任务该用哪个 Skill、或需要确认 Skill 触发边界时触发。 适用于新会话初始化、任务开始前 Skill 选择、Skill 冲突时的决策参考。 本文件为 AIASys 项目团队 Skill 路由总览，直接在项目仓库维护。 不替代具体 Skill 的执行，只提供路由指引。

PR 提交前与合并前检查。当需要创建 PR、审查 PR、合并 PR、 或检查代码是否准备好提交到 dev/main 时触发。 覆盖：gitignore 违规、大文件、敏感文件、task-session 泄漏、 commit message 规范、二进制文件检查、冲突标记残留、 行尾符一致性、skill 注册完整性。 适用于 AIASys 项目的所有 PR 审查场景。

AIASys 项目跨平台兼容性规范（团队版）。当涉及路径处理、文件 IO、进程管理、 编码转换、Shell 命令执行、依赖选型时触发。覆盖三端（Windows、macOS、Linux） 差异陷阱、常见错误模式、正确做法和项目内已有的跨平台基础设施。 触发于：新增文件 IO 操作、使用 subprocess、引入新依赖、处理路径字符串、 遇到平台相关 bug、或需要判断某个 API 是否跨平台安全时。

AIASys 团队 Skill 治理规则与管理指南。 明确 `.team-skills/` 是项目团队直接在 AIASys 仓库中维护的共享 Skill 池，与私人 Skill 解耦； 规定 Team Skill 的准入标准、生命周期、写作规范和维护流程。 当需要决定某个 Skill 是否适合进团队池、如何维护团队 Skill、或处理团队 Skill 与私人 Skill 边界时触发。

AIASys Agent 工具开发规范。当需要为 Agent 创建新工具、实现 Agent 会话管理、 或处理沙盒执行安全时触发。涵盖 Tool 开发五要素、Agent 状态管理、流式输出实现。 适用于 Tool 开发、Agent 状态管理、沙盒执行安全、流式输出实现。 不适用于纯前端 UI 开发、非 Agent 相关的后端 API 开发。

Commit 历史审计与提交规范。当用户要求检查 commit 历史、审计提交质量、 合并/压缩 commit（squash）、整理 git log、删除 stale 分支、 或发现 commit 历史过于冗长/混乱时触发。 触发词："检查 commit 历史"、"审计提交"、"整理 commit"、"合并 commit"、 "commit 太多了"、"git log 很乱"、"历史提交有问题"。 与 aiasys-git-workflow 互补：git-workflow 管提交规范，本 Skill 管历史审计。

AIASys LLM 模型配置管理。说明 LLM 配置的两层存储机制、key 位置、 同步流程、故障排查和验证方法。适用于新环境部署或 LLM 配置变更时。

AIASys Mac 桌面端远程部署与验证。通过 SSH 连接 Mac 设备， 完成代码同步、依赖安装、Electron 二进制处理、后端 venv 搭建、 前端构建、桌面应用启动，以及工作区创建验证。 适用于需要在 Mac 上编译和测试 AIASys 桌面版的场景。

AIASys Skill 维护工作流（团队版）。规定代码变更时如何同步更新团队共享 Skill， 确保 .team-skills/ 与项目实际架构保持一致。触发于：完成开发任务后、 发现团队 Skill 与代码不符、准备提交前。与 .team-skills/sop-workflow 配合使用。

FastAPI 后端 API 开发规范。当需要创建 API 端点、设计请求/响应模型、实现 CRUD 操作或处理 FastAPI 路由时触发。 适用于 API 路由组织、Pydantic 模型定义、错误处理、异步数据库操作。 不适用于前端接口开发、非 FastAPI 框架（如 Django、Flask）、纯数据库模型设计（见 database-model）。

状态流设计规范。当需要设计多步骤工作流、处理复杂状态转换、实现状态机或文档化用户交互流程时触发。 适用于复杂 UI 交互、系统流程、状态机管理、用户操作流程设计。 不适用于简单布尔状态切换、纯展示型组件、无状态业务逻辑。