核心功能: 本技能提供结构化的工作流程和配置指引等能力。
上下文驱动开发(免费版)
概述
上下文驱动开发是针对开发方法论领域的专业化AI辅助工具。免费版面向个人用户,提供核心功能与基础用法,适合快速上手和日常使用. 本工具经过深度优化,增强元数据和适用关键词,完全适配SkillHub平台规范.
核心能力
上下文文档管理、产品愿景记录、技术栈追踪、工作流规范、任务注册表、会话连续性
核心能力(补充)
执行核心能力操作,使用input_params参数进行配置,支持创建/查询/导出等操作.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
基础功能完整覆盖
基础功能完整覆盖
处理: 解析基础功能完整覆盖的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回基础功能完整覆盖的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
简洁易用的操作接口
简洁易用的操作接口
处理: 解析简洁易用的操作接口的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回简洁易用的操作接口的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
标准格式输入输出
标准格式输入输出
处理: 解析标准格式输入输出的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回标准格式输入输出的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
快速上手
快速上手,零配置即可使用
处理: 解析快速上手的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回快速上手的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
适合个人日常使用场景
适合个人日常使用场景
处理: 解析适合个人日常使用场景的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回适合个人日常使用场景的响应数据,包含状态码、结果和日志.
- 执行此能力时使用
input_params参数,支持创建/查询/导出操作
处理: 解析核心能力的输入参数,完成核心逻辑,返回结构化响应.
输出: 返回核心能力的响应数据,包含状态码、结果和日志.
技术实现要点:核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置.
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:将项目上下文作为、可管理制品、通过结构化文档确、辅助开发的一致性、上下文驱动开发、免费版等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
使用场景
场景1:新项目初始化
为新项目创建完整的上下文文档体系。示例指令:`
`初始化新项目的上下文
操作流程:
- 识别用户需求类型
- 加载对应处理模块
- 执行操作并返回结果
场景2:现有项目适配
分析现有代码库,提取技术栈与工作流信息。示例指令:`
`为现有项目建立上下文
场景3:AI开发对齐
通过上下文文档确保AI助手在不同会话中产出一致结果。示例指令:`
`确保AI开发一致性
快速开始
- 阅读## 核心能力章节了解skill功能
- 按## 依赖说明配置环境
- 执行所需能力对应的命令
- 参考## 错误处理章节处理异常
- 查看## FAQ解答常见疑问
环境准备
输入格式
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 上下文驱动开发(免费版)处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
# 确保Python环境可用
python3 --version
# ...
# 依赖说明
pip install requests
基础用法
# 上下文文档结构验证
import os
# ...
context_docs = ["product.md", "tech-stack.md", "workflow.md", "tracks.md"]
context_dir = "./context"
# ...
for doc in context_docs:
path = os.path.join(context_dir, doc)
if os.path.exists(path):
print(f"[OK] {doc} 已存在")
else:
print(f"[缺失] {doc} 需要创建")
执行结果
完成上述代码后,将根据输入参数返回结构化响应。免费版支持单次任务,适合解析单个文件或任务.
示例
context:
root: "./context"
artifacts:
- product.md
- tech-stack.md
- workflow.md
- tracks.md
配置说明
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 基础路径 | 工作目录 | ./ |
| 输出格式 | 结果输出格式 | json |
优秀实践
基础使用建议
- 明确需求:在使用前明确需要处理的内容和期望结果
- 检查输入:确保输入文件格式正确、内容完整
- 保存结果:处理完成后及时保存输出结果
- 定期清理:定期清理临时文件
- 错误处理:遇到错误时检查输入参数
性能优化
# 在此执行相关操作
... # 具体实现请参考上下文文档
常见问题
Q1: 处理速度较慢怎么办?
A: 免费版为单线程处理,对于大文件建议分批处理或升级到专业版获得并行处理能力.
Q2: 支持的文件格式有哪些?
A: 支持标准格式输入输出,常见格式包括JSON、YAML、Markdown等.
Q3: 如何获取API Key?
A: 本skill基于Markdown指令规范,无需额外API Key。如需外部服务API,请参考对应服务的注册流程.
已知限制
A: 免费版支持单次操作,适合个人日常使用。如需批量处理或高级功能,建议升级到专业版.
依赖说明
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
- Python版本: 3.8+
第三方依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
- 本skill基于Markdown指令规范,无需额外API Key
可用性分类
- 分类: MD+EXEC(纯Markdown指令,部分功能需要exec命令行执行能力)
- 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作
- 版本: 免费版(v1.0.0 免费版,核心功能)
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
输出格式
{
"success": true,
"data": {
"result": "上下文驱动开发(免费版)处理结果",
"execution_time": "0.5s",
"metadata": {
"version": "1.0",
"processor": "context driven dev"
}
},
"execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
"error": null
}
评论
加载中…