Store.Management/.agents/skills/add-service/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
add-service	在 PipeReviewReport 客户端中新建一个带接口的 Service，并通过 AutoFac 自动注册。 当用户需要添加新的业务服务、数据服务、或状态管理服务时使用。	false

新建客户端 Service

根据生命周期选择模式

需求	实现接口
单例，无需初始化	ISingletonDependency
单例，需要异步启动初始化	ISingletonDependency + IAppInitializeAsync
单例，需要同步启动初始化	ISingletonDependency + IAppInitialize
单例，需要在应用关闭时清理	+ IAppClosedHandler

模板

最简单的单例 Service

using MAX.Core.DependencyInjections;

namespace PipeReviewReport.<模块名>.Services;

public interface IXxxService
{
    void DoSomething();
}

internal class XxxService : IXxxService, ISingletonDependency
{
    public void DoSomething() { }
}

需要启动初始化的 Service

using MAX.Core.DependencyInjections;
using MAX.Core.Interfaces;

namespace PipeReviewReport.<模块名>.Services;

public interface IXxxService { }

internal class XxxService(IGrpcService grpcService) : IXxxService, IAppInitializeAsync
{
    string IAppInitializeAsync.Description { get; } = "初始化 Xxx 中";
    int IPriority.Priority { get; } = IntPriority.Normal;

    async Task IAppInitializeAsync.AppInitializeAsync(IStatusReport statusReport)
    {
        // 异步初始化逻辑
    }
}

需要初始化 + 关闭清理的 Service

internal class XxxService(IGrpcService grpcService) : IXxxService, IAppInitializeAsync, IAppClosedHandler
{
    string IAppInitializeAsync.Description { get; } = "初始化 Xxx 中";
    int IPriority.Priority { get; } = IntPriority.Normal;

    int IAppClosedHandler.Priority { get; } = IntPriority.Normal;
    string IAppClosedHandler.Description { get; } = "关闭 Xxx 中";

    async Task IAppInitializeAsync.AppInitializeAsync(IStatusReport statusReport)
    {
        // 初始化
    }

    void IAppClosedHandler.AppClosed(AppCloseParameter parameter)
    {
        // 清理资源
    }
}

注意事项

• 实现 ISingletonDependency 后 AutoFac 自动注册为单例，无需手动注册
• 实现 IAppInitializeAsync / IAppInitialize 时必须同时实现 IPriority（提供 Priority 属性）
• 接口定义 public，实现类 internal
• 优先级使用 IntPriority 常量（VeryHigh、High、Normal、Lower、VeryLow）

检查清单

• 接口 public，实现类 internal
• 根据需要选择了正确的生命周期接口组合
• 有初始化/关闭逻辑时实现了 Description 和 Priority
• 使用 Primary Constructor 注入依赖