Files
tools-show/.agents/skills/project-context/SKILL.md
2026-04-11 20:46:55 +08:00

143 lines
4.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
name: project-context
description: 项目上下文管理技能,用于管理用户画像和项目上下文。本技能由 brainstorming 和 executing-plans 技能调用,不独立触发。在 brainstorming 激活时调用以获取用户画像,在 executing-plans 完成时自动更新项目上下文。
license: MIT
metadata:
version: "3.0.1"
---
# 项目上下文技能
本技能管理用户画像和项目上下文,为其他技能提供上下文信息。
---
## 核心职责
| 职责 | 说明 | 维护方式 |
|------|------|---------|
| 用户画像读取 | 加载用户画像,为 brainstorming 提供用户信息 | Agent 自动 |
| 用户画像更新 | 在对话中识别用户偏好,自动更新画像 | Agent 自动 + 主动触发 |
| 项目上下文管理 | 记录项目当前状态,为未来规划提供背景 | Agent 自动executing-plans 完成时) |
---
## 主动更新机制
### 用户画像主动更新触发点
⚠️ **以下情况必须主动更新用户画像**
**技术偏好识别**
- 用户明确表达对某个框架/库的偏好
- 用户在技术选型中表现出倾向性
- 用户展示出新的技术栈使用经验
**决策倾向识别**
- 用户在多个决策中表现出一致倾向(质量优先/效率优先)
- 用户对风险的态度(保守/激进)
- 用户对重构的态度(小步快跑/大步重构)
**交互风格识别**
- 用户偏好详细解释还是简洁说明
- 用户偏好选择题还是开放式问题
- 用户希望在每个步骤确认还是关键节点确认
**能力评估更新**
- 用户在某个领域展示出超出预期的能力
- 用户在某个领域需要更多指导
### 项目上下文主动更新触发点
⚠️ **以下情况必须主动更新项目上下文**
**功能完成时**
- 每个功能实施完成后,必须记录到项目上下文
- 记录技术决策和理由
- 记录遇到的问题和解决方案
**架构变更时**
- 项目结构发生重大变化
- 引入新的依赖或技术栈
- 修改核心设计模式
**测试状态更新**
- 测试覆盖率变化
- 测试策略调整
- 测试框架变更
---
## 文件位置
| 文件 | 路径 | 用途 |
|------|------|------|
| 用户画像 | `design/context/user-profile.md` | 跨会话用户偏好 |
| 项目上下文 | `design/context/project-context.md` | 项目持续状态记录 |
---
## 用户画像
### 基本信息
| 字段 | 内容 | 更新日期 |
|------|------|---------|
| 用户定位 | [高级开发者/中级开发者/产品经理/其他] | - |
| 技术背景 | [主要使用的语言、框架、技术栈] | - |
| 首次记录 | YYYY-MM-DD | - |
| 最后更新 | YYYY-MM-DD | - |
### 技术偏好
| 类型 | 偏好 | 备注 |
|------|------|------|
| 前端端框架 | [React/Vue/Angular/其他] | - |
| 后端语言 | [Node.js/Python/Go/Rust/其他] | - |
| 代码风格 | [具体规范或风格描述] | - |
### 决策倾向
| 场景 | 倾向 | 表现 |
|------|------|------|
| 常规开发 | [质量优先/效率优先/平衡] | [具体表现] |
| 紧急情况 | [质量优先/效率优先/平衡] | [具体表现] |
| 重构场景 | [质量优先/效率优先/平衡] | [具体表现] |
### 风险偏好
- **技术选型**[保守/适中/激进]
- **重构决策**[小步快跑/中步迭代/大步重构]
- **依赖引入**[最小依赖/适度依赖/愿意尝新]
---
## 交互风格
| 方面 | 偏好 | 说明 |
|------|------|------|
| 详细程度 | [详细/简洁/适中] | - |
| 反馈频率 | [每个步骤/关键节点/完成后] | - |
| 解释深度 | [深入解释/概要说明/无需解释] | - |
| 问题形式 | [选择题/开放式/两者皆可] | - |
---
## 能力评估
| 能力领域 | 自评等级 | 备注 |
|---------|---------|------|
| 前端开发 | [初级/中级/高级] | - |
| 后端开发 | [初级/中级/高级] | - |
| 架构设计 | [初级/中级/高级] | - |
| 性能优化 | [初级/中级/高级] | - |
---
## 更新历史
| 日期 | 更新内容 | 触发场景 |
|------|---------|---------|
| YYYY-MM-DD | [初始创建] | 首次对话 |
| YYYY-MM-DD | [更新内容] | [触发场景] |