add-route-context
为Flutter页面添加路由上下文记录功能,支持日期等参数的AI上下文识别。当需要让AI助手通过"询问当前上下文"功能获取页面状态(如日期、ID等参数)时使用。适用场景:(1) 日期驱动的页面(日记、活动、日历等),(2) ID驱动的页面(用户详情、订单详情等),(3) 任何需要AI理解当前页面参数的场景
When & Why to Use This Skill
This Claude skill automates the integration of route context tracking within Flutter applications, enabling AI assistants to maintain real-time awareness of the user's current page state. By programmatically injecting context-recording logic into Flutter widgets, it ensures that parameters like dates, user IDs, and page titles are synchronized with the AI's memory, allowing for highly accurate, context-aware interactions and 'Ask Current Context' functionality.
Use Cases
- 1. Context-Aware AI Support: Enabling AI assistants to instantly identify the specific item (e.g., Order ID, User Profile) a user is viewing to provide relevant help without manual input.
- 2. Date-Driven Content Analysis: Automatically updating the AI's context when users browse through calendars, diaries, or activity logs, allowing the AI to summarize specific time-based data.
- 3. Seamless State Synchronization: Ensuring that as users navigate through complex app workflows, the AI agent's internal state remains perfectly aligned with the visual UI state.
- 4. Enhanced Developer Productivity: Automating the boilerplate code required to make Flutter routes 'AI-readable,' reducing manual implementation errors in agentic application development.
| name | add-route-context |
|---|---|
| description | 为Flutter页面添加路由上下文记录功能,支持日期等参数的AI上下文识别。当需要让AI助手通过"询问当前上下文"功能获取页面状态(如日期、ID等参数)时使用。适用场景:(1) 日期驱动的页面(日记、活动、日历等),(2) ID驱动的页面(用户详情、订单详情等),(3) 任何需要AI理解当前页面参数的场景 |
Add Route Context
为Flutter页面添加路由上下文记录,使AI助手能理解用户当前查看的页面参数。
Workflow
1. Analyze Target File
Read the target file and identify:
- State class name
- Parameter variable (e.g.,
_selectedDate,_userId) - Parameter change method (e.g.,
_onDateChanged) - Initialization method (e.g.,
initState,_initializeService)
2. Add RouteHistoryManager Import
import 'package:Memento/core/route/route_history_manager.dart';
3. Create Update Method
For DateTime parameter:
/// 更新路由上下文,使"询问当前上下文"功能能获取到当前日期
void _updateRouteContext(DateTime date) {
final dateStr = '${date.year}-${date.month.toString().padLeft(2, '0')}-${date.day.toString().padLeft(2, '0')}';
RouteHistoryManager.updateCurrentContext(
pageId: "/route_name",
title: '页面标题 - $dateStr',
params: {'date': dateStr},
);
}
For custom parameter:
/// 更新路由上下文
void _updateRouteContext(String paramValue) {
RouteHistoryManager.updateCurrentContext(
pageId: "/route_name",
title: '页面标题 - $paramValue',
params: {'paramName': paramValue},
);
}
4. Call in Initialization
Add call at end of initialization method:
Future<void> _initializeService() async {
// ... existing code ...
// 初始化时设置路由上下文
_updateRouteContext(_initialParam);
}
5. Call on Parameter Change
Add call in parameter change handler:
void _onParamChanged(ParamType newParam) {
if (newParam == _currentParam) return;
setState(() {
_currentParam = newParam;
});
// ... existing code ...
// 更新路由上下文
_updateRouteContext(newParam);
}
6. Update Route Parser
Add route template to lib/core/action/built_in/ask_context_action/route_parser.dart:
static const Map<String, String> _routeTemplates = {
// ... existing routes ...
// 插件名称
'/route_name': '用户正在查看 {paramName} 的XXX',
};
DateTime parameter example:
'/activity_timeline': '用户正在查看 {date} 的活动时间轴',
Custom parameter example:
'/user_profile': '用户正在查看 {userId} 的用户资料',
Detection Patterns
DateTime Variables
Look for variables matching:
- Names:
_selectedDate,_currentDate,_focusedDay,date - Type:
DateTime
Look for methods matching:
- Names:
_onDateChanged,_onDayChanged,_selectDate - Parameter type:
DateTime
Custom Parameters
Look for variables matching the --param argument name.
Result
After execution:
在页面加载时:
- AI上下文:
用户正在查看 2025-12-22 的活动时间轴
在参数变化时:
- AI上下文自动更新:
用户正在查看 2025-12-21 的活动时间轴
Notes
- Extract update logic to separate method to avoid duplication
- Use Chinese comments matching existing codebase style
- Format dates as
YYYY-MM-DDfor consistency - Route parser uses
RegExp(r'\{(\w+)\}')for placeholder replacement - Verify with
flutter analyzeafter changes