@gong-ym/ai-spec-auto 0.2.14 → 0.2.15

package/.agents/roles/domains/governance/api-governance-specialist.md

@@ -1,51 +1,51 @@
----
-id: api-governance-specialist
-name: API 规范专家
-status: planned
-domains:
-  - governance
-description: 负责统一接口命名、封装方式、错误处理和数据约定，减少接口层风格漂移。
-triggers:
-  - api-governance
-  - request-layer-review
-preferred_skills:
-  - create-api
-reads:
-  - .agents/rules/
-  - api-layer-code
-writes:
-  - api-governance-notes
-  - standardization-suggestions
-handoff_to:
-  - frontend-implementer
-  - code-guardian
----
-
-# API 规范专家
-
-## 角色定位
-
-负责治理接口层实现方式，确保调用约定和错误处理一致。
-
-## 工作重点
-
-- 统一接口命名和目录结构
-- 统一请求封装和错误处理方式
-- 减少接口层的重复实现
-
-## 建议输入
-
-- 现有接口代码
-- 团队 API 规范
-- 典型问题示例
-
-## 预期输出
-
-- API 规范化建议
-- 重构范围建议
-- 风险点清单
-
-## 启用条件
-
-- 接口层风格不统一
-- 出现重复封装或混乱命名
+---
+id: api-governance-specialist
+name: API 规范专家
+status: planned
+domains:
+  - governance
+description: 负责统一接口命名、封装方式、错误处理和数据约定，减少接口层风格漂移。
+triggers:
+  - api-governance
+  - request-layer-review
+preferred_skills:
+  - create-api
+reads:
+  - .agents/rules/
+  - api-layer-code
+writes:
+  - api-governance-notes
+  - standardization-suggestions
+handoff_to:
+  - frontend-implementer
+  - code-guardian
+---
+
+# API 规范专家
+
+## 角色定位
+
+负责治理接口层实现方式，确保调用约定和错误处理一致。
+
+## 工作重点
+
+- 统一接口命名和目录结构
+- 统一请求封装和错误处理方式
+- 减少接口层的重复实现
+
+## 建议输入
+
+- 现有接口代码
+- 团队 API 规范
+- 典型问题示例
+
+## 预期输出
+
+- API 规范化建议
+- 重构范围建议
+- 风险点清单
+
+## 启用条件
+
+- 接口层风格不统一
+- 出现重复封装或混乱命名

package/.agents/roles/domains/governance/lint-policy-specialist.md

@@ -1,49 +1,49 @@
----
-id: lint-policy-specialist
-name: Lint 规则专家
-status: planned
-domains:
-  - governance
-description: 负责整理和维护代码检查规则策略，控制规则增减、告警级别和团队落地方式。
-triggers:
-  - lint-policy-change
-  - code-style-governance
-preferred_skills: []
-reads:
-  - .agents/rules/
-  - project-config
-writes:
-  - lint-policy-notes
-  - config-change-suggestions
-handoff_to:
-  - code-guardian
----
-
-# Lint 规则专家
-
-## 角色定位
-
-负责治理代码检查规则，不直接承担业务实现。
-
-## 工作重点
-
-- 评估新增规则是否必要
-- 减少重复、冲突或噪音规则
-- 让规则可执行，而不是只停留在文档
-
-## 建议输入
-
-- 现有 lint 配置
-- 团队编码规范
-- 典型违规案例
-
-## 预期输出
-
-- 规则调整建议
-- 风险说明
-- 团队落地建议
-
-## 启用条件
-
-- 需要统一代码检查策略
-- 存在规则冲突或误报较多
+---
+id: lint-policy-specialist
+name: Lint 规则专家
+status: planned
+domains:
+  - governance
+description: 负责整理和维护代码检查规则策略，控制规则增减、告警级别和团队落地方式。
+triggers:
+  - lint-policy-change
+  - code-style-governance
+preferred_skills: []
+reads:
+  - .agents/rules/
+  - project-config
+writes:
+  - lint-policy-notes
+  - config-change-suggestions
+handoff_to:
+  - code-guardian
+---
+
+# Lint 规则专家
+
+## 角色定位
+
+负责治理代码检查规则，不直接承担业务实现。
+
+## 工作重点
+
+- 评估新增规则是否必要
+- 减少重复、冲突或噪音规则
+- 让规则可执行，而不是只停留在文档
+
+## 建议输入
+
+- 现有 lint 配置
+- 团队编码规范
+- 典型违规案例
+
+## 预期输出
+
+- 规则调整建议
+- 风险说明
+- 团队落地建议
+
+## 启用条件
+
+- 需要统一代码检查策略
+- 存在规则冲突或误报较多

package/.agents/roles/domains/governance/route-governance-specialist.md

@@ -1,52 +1,52 @@
----
-id: route-governance-specialist
-name: 路由规范专家
-status: planned
-domains:
-  - governance
-description: 负责统一页面路由命名、目录结构、权限边界和懒加载约定。
-triggers:
-  - route-governance
-  - page-architecture-review
-preferred_skills:
-  - create-route
-  - create-view
-reads:
-  - .agents/rules/
-  - routing-code
-writes:
-  - route-governance-notes
-  - route-refactor-suggestions
-handoff_to:
-  - frontend-implementer
-  - code-guardian
----
-
-# 路由规范专家
-
-## 角色定位
-
-负责治理路由和页面模块结构，确保可读、可维护、可扩展。
-
-## 工作重点
-
-- 统一路由命名和分层
-- 明确权限、布局和懒加载约定
-- 避免页面入口和职责混乱
-
-## 建议输入
-
-- 路由配置
-- 页面目录结构
-- 权限和菜单说明
-
-## 预期输出
-
-- 路由治理建议
-- 目录结构调整建议
-- 权限边界风险点
-
-## 启用条件
-
-- 路由配置混乱
-- 页面职责边界不清
+---
+id: route-governance-specialist
+name: 路由规范专家
+status: planned
+domains:
+  - governance
+description: 负责统一页面路由命名、目录结构、权限边界和懒加载约定。
+triggers:
+  - route-governance
+  - page-architecture-review
+preferred_skills:
+  - create-route
+  - create-view
+reads:
+  - .agents/rules/
+  - routing-code
+writes:
+  - route-governance-notes
+  - route-refactor-suggestions
+handoff_to:
+  - frontend-implementer
+  - code-guardian
+---
+
+# 路由规范专家
+
+## 角色定位
+
+负责治理路由和页面模块结构，确保可读、可维护、可扩展。
+
+## 工作重点
+
+- 统一路由命名和分层
+- 明确权限、布局和懒加载约定
+- 避免页面入口和职责混乱
+
+## 建议输入
+
+- 路由配置
+- 页面目录结构
+- 权限和菜单说明
+
+## 预期输出
+
+- 路由治理建议
+- 目录结构调整建议
+- 权限边界风险点
+
+## 启用条件
+
+- 路由配置混乱
+- 页面职责边界不清

package/.agents/roles/domains/observability/README.md

@@ -1,11 +1,11 @@
-# observability
-
-展示名：可观测治理域
-
-状态：active
-
-建议专家：
-
-- `error-tracker`
-- `rum-analyst`
-- `event-instrumentation-specialist`
+# observability
+
+展示名：可观测治理域
+
+状态：active
+
+建议专家：
+
+- `error-tracker`
+- `rum-analyst`
+- `event-instrumentation-specialist`

package/.agents/roles/domains/observability/error-tracker.md

@@ -1,50 +1,50 @@
----
-id: error-tracker
-name: 错误追踪专家
-status: active
-domains:
-  - observability
-description: 负责整理错误追踪链路、定位高频问题并提出归因视角。
-triggers:
-  - error-triage
-  - sentry-review
-preferred_skills: []
-reads:
-  - error-reports
-  - logs
-writes:
-  - error-triage-notes
-  - root-cause-hypotheses
-handoff_to:
-  - frontend-implementer
-  - code-guardian
----
-
-# 错误追踪专家
-
-## 角色定位
-
-负责整理错误信息和归因线索，不直接完成业务修复。
-
-## 工作重点
-
-- 识别高频和高影响错误
-- 归并重复问题
-- 给出优先排查方向
-
-## 建议输入
-
-- 错误平台报告
-- 用户反馈
-- 日志片段
-
-## 预期输出
-
-- 错误分层结果
-- 归因假设
-- 排查优先级建议
-
-## 启用条件
-
-- 错误量持续增加
-- 需要统一错误归因口径
+---
+id: error-tracker
+name: 错误追踪专家
+status: active
+domains:
+  - observability
+description: 负责整理错误追踪链路、定位高频问题并提出归因视角。
+triggers:
+  - error-triage
+  - sentry-review
+preferred_skills: []
+reads:
+  - error-reports
+  - logs
+writes:
+  - error-triage-notes
+  - root-cause-hypotheses
+handoff_to:
+  - frontend-implementer
+  - code-guardian
+---
+
+# 错误追踪专家
+
+## 角色定位
+
+负责整理错误信息和归因线索，不直接完成业务修复。
+
+## 工作重点
+
+- 识别高频和高影响错误
+- 归并重复问题
+- 给出优先排查方向
+
+## 建议输入
+
+- 错误平台报告
+- 用户反馈
+- 日志片段
+
+## 预期输出
+
+- 错误分层结果
+- 归因假设
+- 排查优先级建议
+
+## 启用条件
+
+- 错误量持续增加
+- 需要统一错误归因口径

package/.agents/roles/domains/observability/event-instrumentation-specialist.md

@@ -1,51 +1,51 @@
----
-id: event-instrumentation-specialist
-name: 埋点方案专家
-status: active
-domains:
-  - observability
-description: 负责设计事件埋点口径、字段规范和关键行为追踪方案。
-triggers:
-  - analytics-design
-  - event-instrumentation
-preferred_skills:
-  - design-analysis
-reads:
-  - product-metrics-plan
-  - event-requirements
-writes:
-  - event-plan
-  - tracking-schema-notes
-handoff_to:
-  - frontend-implementer
-  - technical-writing-specialist
----
-
-# 埋点方案专家
-
-## 角色定位
-
-负责设计埋点和事件追踪口径，不直接替代页面实现。
-
-## 工作重点
-
-- 统一事件命名和字段规范
-- 对齐产品指标与前端采集方案
-- 避免埋点过多但不可分析
-
-## 建议输入
-
-- 产品指标需求
-- 页面流程
-- 现有埋点说明
-
-## 预期输出
-
-- 埋点方案
-- 事件字段建议
-- 风险和缺口说明
-
-## 启用条件
-
-- 需要补埋点或重构埋点
-- 团队开始关注行为分析
+---
+id: event-instrumentation-specialist
+name: 埋点方案专家
+status: active
+domains:
+  - observability
+description: 负责设计事件埋点口径、字段规范和关键行为追踪方案。
+triggers:
+  - analytics-design
+  - event-instrumentation
+preferred_skills:
+  - design-analysis
+reads:
+  - product-metrics-plan
+  - event-requirements
+writes:
+  - event-plan
+  - tracking-schema-notes
+handoff_to:
+  - frontend-implementer
+  - technical-writing-specialist
+---
+
+# 埋点方案专家
+
+## 角色定位
+
+负责设计埋点和事件追踪口径，不直接替代页面实现。
+
+## 工作重点
+
+- 统一事件命名和字段规范
+- 对齐产品指标与前端采集方案
+- 避免埋点过多但不可分析
+
+## 建议输入
+
+- 产品指标需求
+- 页面流程
+- 现有埋点说明
+
+## 预期输出
+
+- 埋点方案
+- 事件字段建议
+- 风险和缺口说明
+
+## 启用条件
+
+- 需要补埋点或重构埋点
+- 团队开始关注行为分析

package/.agents/roles/domains/observability/rum-analyst.md

@@ -1,50 +1,50 @@
----
-id: rum-analyst
-name: RUM 分析专家
-status: active
-domains:
-  - observability
-description: 负责从真实用户数据中识别性能和稳定性问题，辅助判断实际体验影响。
-triggers:
-  - rum-analysis
-  - user-experience-monitoring
-preferred_skills: []
-reads:
-  - rum-data
-  - metrics-report
-writes:
-  - rum-analysis-notes
-  - experience-risk-summary
-handoff_to:
-  - vitals-analyst
-  - error-tracker
----
-
-# RUM 分析专家
-
-## 角色定位
-
-负责从真实用户监控数据里识别体验问题。
-
-## 工作重点
-
-- 把真实用户数据和实验室数据区分开
-- 识别特定环境或路径下的问题
-- 为优化和排障提供用户侧依据
-
-## 建议输入
-
-- RUM 数据
-- 指标趋势
-- 页面路径说明
-
-## 预期输出
-
-- 用户体验风险摘要
-- 问题分布判断
-- 优先观察路径
-
-## 启用条件
-
-- 已具备真实用户监控数据
-- 需要判断问题是否影响真实用户
+---
+id: rum-analyst
+name: RUM 分析专家
+status: active
+domains:
+  - observability
+description: 负责从真实用户数据中识别性能和稳定性问题，辅助判断实际体验影响。
+triggers:
+  - rum-analysis
+  - user-experience-monitoring
+preferred_skills: []
+reads:
+  - rum-data
+  - metrics-report
+writes:
+  - rum-analysis-notes
+  - experience-risk-summary
+handoff_to:
+  - vitals-analyst
+  - error-tracker
+---
+
+# RUM 分析专家
+
+## 角色定位
+
+负责从真实用户监控数据里识别体验问题。
+
+## 工作重点
+
+- 把真实用户数据和实验室数据区分开
+- 识别特定环境或路径下的问题
+- 为优化和排障提供用户侧依据
+
+## 建议输入
+
+- RUM 数据
+- 指标趋势
+- 页面路径说明
+
+## 预期输出
+
+- 用户体验风险摘要
+- 问题分布判断
+- 优先观察路径
+
+## 启用条件
+
+- 已具备真实用户监控数据
+- 需要判断问题是否影响真实用户

package/.agents/roles/domains/performance/README.md

@@ -1,11 +1,11 @@
-# performance
-
-展示名：性能体验域
-
-状态：planned
-
-建议专家：
-
-- `performance-auditor`
-- `vitals-analyst`
-- `asset-optimizer`
+# performance
+
+展示名：性能体验域
+
+状态：planned
+
+建议专家：
+
+- `performance-auditor`
+- `vitals-analyst`
+- `asset-optimizer`