定义应用并编写第一个提示

一个有用的第一个提示可识别技术、应用行为、约束以及显示工作已完成的证据。 这减少了助手选择熟悉但不正确的Windows框架的可能性。

从接受条件开始

在请求代码之前,请定义预期观察到的内容:

  1. 项目为 x64 生成,不会出现错误或警告。
  2. 应用使用 WinUI 3, Microsoft.UI.Xaml而不是 UWP 和 Windows.UI.Xaml。
  3. 用户可以添加、完成和删除任务。
  4. 应用重启后,任务将保持不变。
  5. 每个输入和命令都有可访问的名称。
  6. 当窗口较窄时,命令将保持可用。
  7. 助手解释需要包标识或窗口初始化的任何 API。

这些标准将宽泛的请求转化为你和助手都可以执行的检查项。

为助手设定持久性约束

打开保存开发项目的文件夹,启动 AI 编码助手,并使用此提示:

Create a C# WinUI 3 desktop app named TaskTally.

Technology constraints:
- Use WinUI 3 and the current stable Windows App SDK.
- Use Microsoft.UI.Xaml namespaces. Don't use UWP, Windows.UI.Xaml,
  WPF, Windows Forms, .NET MAUI, or third-party UI controls.
- Create a packaged app and build for x64.
- Start from the dotnet new winui-mvvm template.
- Use CommunityToolkit.Mvvm for observable properties and commands.

App requirements:
- Show a single-page task list.
- Let the user add, complete, and delete tasks.
- Save tasks as JSON in the app's local storage.
- Use ListView for the collection and InfoBar for save status.
- Include an empty state, keyboard access, accessible names, and a
  layout that works at narrow window widths.

Working agreement:
- First show your implementation plan and the files you will change.
- Make one small, buildable change at a time.
- Build after each change and fix errors before continuing.
- Explain which Learn documentation supports any Windows API choice.
- Don't suppress warnings or replace packaged deployment with an
  unpackaged workaround.

最后一节很重要。 它要求助手公开其假设并生成更易于检查的检查点。

查看拟议计划

在批准编辑之前,请检查计划是否包括:

  • 一个任务,一个模型。
  • 包含可观察集合和命令的视图模型。
  • 存储服务。
  • 该页面的 XAML。
  • 如果需要,可为视图特定事件编写少量后台代码。
  • 打包的 WinUI 应用的生成和启动步骤。

如果助手提出使用数据库、依赖注入、多页面或自定义控件,请让它修改其计划。 这些选项可以在较大的应用中有效,但它们会添加此初学者应用不需要的概念。

创建项目

助手应运行与以下命令等效的命令:

dotnet new winui-mvvm -n TaskTally
cd TaskTally
dotnet build -p:Platform=x64

如果使用Visual Studio,可以改为创建打包的 C# WinUI 项目并添加 MVVM 工具包。 保留项目名称 TaskTally ,使本教程中的命名空间匹配。

Note

打包的 WinUI 应用必须使用其包标识进行部署。 使用 Visual Studio、结合受支持的 WinUI 模板使用 winapp,或使用 dotnet run CLI。 不要直接启动生成出的 .exe。

检查生成的项目

询问:

Explain the purpose of App.xaml, MainWindow.xaml, MainPage.xaml,
Package.appxmanifest, and TaskTally.csproj. For each file, identify
the WinUI 3 or Windows App SDK setting that proves this isn't a UWP,
WPF, or MAUI project.

自行验证说明:

  • 项目文件包含 <UseWinUI>true</UseWinUI>。
  • 项目引用 Microsoft.WindowsAppSDK。
  • XAML 代码使用 C# 中的 Microsoft.UI.Xaml 类型。
  • Package.appxmanifest 提供包标识。
  • 目标框架包括Windows,例如net10.0-windows10.0.26100.0。

在添加功能之前生成未更改的模板。 如果基线无法构建,请先解决环境问题或项目创建问题,然后再要求助手生成更多代码。