NewLife Copilot 资产统一管理库——集中管理 NewLife 系列项目可复用的 Copilot 资产：全局指令、专用指令、技能、智能体。
克隆到任意机器后执行一条脚本即可安装到 VS Code 用户数据目录，无需在每个项目放一份 .github。
资产采用最小化策略，分三层承担不同职责：
| 层级 | 载体 | 内容 | 维护成本 |
|---|---|---|---|
| Tier 1 | NuGet 包 XML 注释 | 类与成员的「如何使用」 | 跟代码一起维护 |
| Tier 2 | 本仓库全局 instructions | NewLife 反常规约定（硬约束） | 极低，集中维护 |
| Tier 3 | 本仓库 skill / agent | 流程类、架构决策类、跨组件取舍 | 仅必要项 |
判定原则：能由 XML 注释或通用知识覆盖的，不做 skill；能由全局 instructions 承担的，不做专用 instructions。
git clone https://github.com/NewLifeX/NewLife.Skills.git
cd NewLife.Skills
.\scripts\install-copilot-assets.ps1安装完成后重启 VS Code，所有项目即可使用全部资产。
直接重新执行 install-copilot-assets.ps1。脚本基于 manifest 自动同步：
- 新资产 → 复制
- 仓库已删除但上次安装过的 → 自动清理（孤儿清理）
- 不会触碰 manifest 之外的文件
如果之前用过旧版安装脚本（没有 manifest），磁盘上残留了大量旧 skill / instructions / agent，加 -AssumeAllOrphans 一次性清理：
# 先预览将清理什么
.\scripts\install-copilot-assets.ps1 -AssumeAllOrphans -WhatIf
# 确认后执行
.\scripts\install-copilot-assets.ps1 -AssumeAllOrphans.\scripts\install-copilot-assets.ps1 -Uninstall项目文档规范：NewLife 项目的
Doc/目录标准产物（需求文档、功能清单、架构设计、竞品分析）见development-process技能。基础约定（文档命名、反模式）见development.instructions.md。通过 README 导航即可，无需独立索引文件。
.github/copilot-instructions.md——所有 NewLife 项目通用的硬约束：加载标注、兼容性、命名/类型/风格规范、防御性注释、内置工具优先、工作流。
| 文件 | 触发场景 |
|---|---|
xcode.instructions.md |
XCode / Model.xml / 实体生成 / 数据库 ORM |
cube.instructions.md |
Cube / 魔方 / 后台管理 / EntityController / Area 区域 |
development.instructions.md |
新建系统 / 需求分析 / 架构设计 / 迭代开发 / 自治模式 |
存放于 .github/skills/，每个技能一个子目录：
| 技能 | 适用场景 |
|---|---|
xcode-data-modeling |
设计 Model.xml、xcode 命令生成实体 |
cube-mvc-backend |
Cube 后台管理深度定制：字段速查、视图覆盖、ConfigController |
project-architecture |
两层/三层架构选型、充血模型、Service 抽取判断 |
development-process |
新建系统研发全流程：需求文档、功能清单、架构设计、迭代开发、自治批处理模式 |
testing-strategy |
单元测试（xUnit）/集成测试（SQLite）测试策略 |
e2e-testing |
NewLife 前端/Cube 的 Playwright E2E 标准：搭建/登录会话复用/标准场景清单/失败截图/数据隔离 |
benchmark-testing |
BenchmarkDotNet 基准测试：设计/运行/结果分析/性能报告 |
cross-compatibility-testing |
竞品交叉兼容测试：文件格式/网络协议/编解码多模式验证 |
xml-comment-enrichment |
XML 注释 AI 友好化刷新：分级补全 <summary>/<param>/<returns>/<example>/<remarks> |
存放于 .github/agents/：
| Agent | 用途 |
|---|---|
competitive-analysis |
联网搜索竞品、功能对比矩阵、输出竞品分析报告 |
benchmark-testing |
BenchmarkDotNet 流程化性能测试、基准报告 |
release-prep |
月度发版准备（ChangeLog/版本号/PackageReleaseNotes） |
project-init |
新项目初始化（NewLife 技术栈脚手架） |
code-review |
按 NewLife 规范审查代码 |
dev-loop |
自治开发循环：选功能→实现→测试→DoD自检+完成凭证→更新清单→提交→批次末自审→检查点报告 |
doc-sync |
代码↔文档双向同步：从代码重建文档体系，或用文档审计代码一致性 |
implementation-audit |
实现缺口审计：逐功能对照需求文档，发现未完整实现的功能并规划修复 |
存放于 .github/prompts/：
| 文件 | 用途 |
|---|---|
doc-writer.prompt.md |
为 C# 代码生成高质量 Markdown 文档 |
.github/
copilot-instructions.md # 全局 Copilot 协作规范（必须遵守）
instructions/ # 专用指令（关键词触发）
skills/ # 技能（按需加载）
agents/ # 智能体（@ 调用）
prompts/ # 提示词模板
docs/ # 维护原则与治理文档
scripts/
install-copilot-assets.ps1
install-copilot-assets.ps1 将资产复制到：
| 资产 | 目标 |
|---|---|
Skills (<name>/SKILL.md) |
%USERPROFILE%\.copilot\skills\ |
| Instructions / Prompts / Agents | %APPDATA%\Code\User\prompts\ |
| 全局指令 | %APPDATA%\Code\User\prompts\newlife-global.instructions.md |
- 30 天淘汰制：连续 30 天未触发的 skill / instructions 进入删除候选
- 搬运型禁止：能由 XML 注释或通用知识覆盖的内容不做 skill
- 单一事实源：API 用法首选 XML 注释；架构决策首选 skill；硬约束首选全局 instructions
- 改动验证：修改后在真实项目随机提一个相关问题，观察「生效」标注是否符合预期
将本仓库资产安装到 VS Code 后，建议在你的项目 README.md 中声明以下信息，帮助 AI 更准确地工作（开发循环 agent 会优先读取）：
## AI 协作声明
- **项目类型**：.NET 后端 / Node.js 前端 / 全栈
- **编译命令**：`dotnet build` / `pnpm build`
- **测试命令**：`dotnet test` / `pnpm test`
- **核心项目**：`src/MyApp.Service`（后端）、`src/MyApp.Web`（前端）声明后，开发循环 agent 的编译/测试命令检测步骤会优先以 README 声明为准，无需每次手动指定。