update
This commit is contained in:
142
.agents/skills/project-context/SKILL.md
Normal file
142
.agents/skills/project-context/SKILL.md
Normal file
@@ -0,0 +1,142 @@
|
||||
---
|
||||
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 | [更新内容] | [触发场景] |
|
||||
@@ -0,0 +1,88 @@
|
||||
# 项目上下文模板
|
||||
|
||||
本文档记录项目的持续状态,为未来功能规划提供项目背景信息。
|
||||
|
||||
---
|
||||
|
||||
## 基本信息
|
||||
|
||||
| 字段 | 内容 |
|
||||
|------|------|
|
||||
| **项目名称** | [项目名称] |
|
||||
| **技术栈** | [主要使用的语言、框架、技术] |
|
||||
| **创建日期** | YYYY-MM-DD |
|
||||
| **最后更新** | YYYY-MM-DD |
|
||||
| **项目阶段** | [初创/开发中/稳定维护/重构中] |
|
||||
|
||||
---
|
||||
|
||||
## 已完成功能
|
||||
|
||||
按功能模块组织,记录已实现并通过测试的功能。
|
||||
|
||||
| 功能 | 描述 | 完成日期 | 状态 |
|
||||
|------|------|---------|------|
|
||||
| [模块名] | [功能描述] | YYYY-MM-DD | 稳定/待优化 |
|
||||
|
||||
---
|
||||
|
||||
## 项目结构
|
||||
|
||||
### 目录结构
|
||||
|
||||
```
|
||||
/
|
||||
├── src/ # 源代码目录
|
||||
├── tests/ # 测试目录
|
||||
├── docs/ # 文档目录
|
||||
└── config/ # 配置文件目录
|
||||
```
|
||||
|
||||
### 模块划分
|
||||
|
||||
| 模块 | 职责 | 依赖关系 |
|
||||
|------|------|---------|
|
||||
| [模块名] | [职责描述] | [依赖的模块] |
|
||||
|
||||
---
|
||||
|
||||
## 架构决策记录
|
||||
|
||||
记录重要的架构决策及其理由,供未来参考。
|
||||
|
||||
| 日期 | 决策 | 理由 | 影响 |
|
||||
|------|------|------|------|
|
||||
| YYYY-MM-DD | [决策内容] | [决策理由] | [影响范围] |
|
||||
|
||||
---
|
||||
|
||||
## 依赖管理
|
||||
|
||||
### 项目依赖
|
||||
|
||||
| 依赖名称 | 版本 | 用途 | 来源 |
|
||||
|---------|------|------|------|
|
||||
| [依赖] | x.x.x | [用途] | npm/pypi/cargo/etc |
|
||||
|
||||
### 外部服务
|
||||
|
||||
| 服务 | 用途 | 配置位置 |
|
||||
|------|------|---------|
|
||||
| [服务名] | [用途] | [配置文件] |
|
||||
|
||||
---
|
||||
|
||||
## 技术债务
|
||||
|
||||
| 债务 | 影响 | 优先级 | 备注 |
|
||||
|------|------|-------|------|
|
||||
| [债务描述] | [影响说明] | 高/中/低 | [备注] |
|
||||
|
||||
---
|
||||
|
||||
## 更新历史
|
||||
|
||||
| 日期 | 更新内容 | 触发来源 |
|
||||
|------|---------|---------|
|
||||
| YYYY-MM-DD | [初始创建] | 项目初始化 |
|
||||
| YYYY-MM-DD | [更新内容] | executing-plans 完成 |
|
||||
@@ -0,0 +1,73 @@
|
||||
# 用户画像模板
|
||||
|
||||
本文档记录用户的跨会话偏好和特征,用于指导 Agent 的交互方式。
|
||||
|
||||
---
|
||||
|
||||
## 基本信息
|
||||
|
||||
| 字段 | 内容 | 更新日期 |
|
||||
|------|------|---------|
|
||||
| 用户定位 | [高级开发者/中级开发者/产品经理/其他] | - |
|
||||
| 技术背景 | [主要使用的语言、框架、技术栈] | - |
|
||||
| 首次记录 | YYYY-MM-DD | - |
|
||||
| 最后更新 | YYYY-MM-DD | - |
|
||||
|
||||
---
|
||||
|
||||
## 技术偏好
|
||||
|
||||
| 类型 | 偏好 | 备注 |
|
||||
|------|------|------|------|
|
||||
| 前端框架 | [React/Vue/Angular/其他] | - |
|
||||
| 后端语言 | [Node.js/Python/Go/Rust/其他] | - |
|
||||
| 代码风格 | [具体规范或风格描述] | - |
|
||||
|
||||
---
|
||||
|
||||
## 决策倾向
|
||||
|
||||
| 场景 | 倾向 | 表现 |
|
||||
|------|------|------|
|
||||
| 常规开发 | [质量优先/效率优先/平衡] | [具体表现] |
|
||||
| 紧急情况 | [质量优先/效率优先/平衡] | [具体表现] |
|
||||
| 重构场景 | [质量优先/效率优先/平衡] | [具体表现] |
|
||||
|
||||
---
|
||||
|
||||
## 风险偏好
|
||||
|
||||
- **技术选型**:[保守/适中/激进]
|
||||
- **重构决策**:[小步快跑/中步迭代/大步重构]
|
||||
- **依赖引入**:[最小依赖/适度依赖/愿意尝新]
|
||||
|
||||
---
|
||||
|
||||
## 交互风格
|
||||
|
||||
| 方面 | 偏好 | 说明 |
|
||||
|------|------|------|------|
|
||||
| 详细程度 | [详细/简洁/适中] | - |
|
||||
| 反馈频率 | [每个步骤/关键节点/完成后] | - |
|
||||
| 解释深度 | [深入解释/概要说明/无需解释] | - |
|
||||
| 问题形式 | [选择题/开放式/两者皆可] | - |
|
||||
|
||||
---
|
||||
|
||||
## 能力评估
|
||||
|
||||
| 能力领域 | 自评等级 | 备注 |
|
||||
|---------|---------|------|
|
||||
| 前端开发 | [初级/中级/高级] | - |
|
||||
| 后端开发 | [初级/中级/高级] | - |
|
||||
| 架构设计 | [初级/中级/高级] | - |
|
||||
| 性能优化 | [初级/中级/高级] | - |
|
||||
|
||||
---
|
||||
|
||||
## 更新历史
|
||||
|
||||
| 日期 | 更新内容 | 触发场景 |
|
||||
|------|---------|---------|
|
||||
| YYYY-MM-DD | [初始创建] | 首次对话 |
|
||||
| YYYY-MM-DD | [更新内容] | [触发场景] |
|
||||
Reference in New Issue
Block a user