上下文驱动开发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/context-driven-dev-2。
技能介绍
问题背景
项目变大后,审查、依赖升级和文档往往各自为政:人工扫漏洞要翻 lockfile,复杂度只能靠经验猜,设计决策又散落在 wiki 与 PR 评论里。Context-Driven Devel 把「结构化上下文」和代码工件绑在一起,让 Agent 在同一次调用里既能读路径、跑分析,也能产出可复用的上下文文档。
技能如何工作
按 SKILL.md 的能力矩阵,技能主要覆盖六块:
- 静态分析与质量评级:输入源码路径,输出问题清单与修改建议。
- 依赖漏洞检测:针对项目依赖给出漏洞报告与升级建议。
- 批量代码评审:对多文件生成评审报告与质量指标。
- CI/CD 衔接:面向构建配置,返回自动化测试结果与部署状态类输出(需你在流水线里显式调用技能并传参)。
- 复杂度可视化与重构建议:基于代码文件给出复杂度视图与重构方向。
- 结构化上下文文档:把项目文档、变更记录整理成结构化 context,与代码并行维护。
典型调用链:确认运行环境 → 在 Agent 对话中挂载技能 → 传入 content(如源码路径或项目路径)、可选 mode(json / text / markdown)、max_retries、skip_steps → 按输出做后续处理。文档处理场景还支持指定格式后做转换与分页信息查看。
适用边界
- FAQ 明确:没有清晰技术栈的模糊需求不适合;更适合需求与技术选型已定的工程。
- 代码处理格式以文档列出的 Python、JavaScript、Java、C#、C++ 为主,其它语言需先验证。
- 依赖侧依赖 Agent 内置 LLM 与文档中的分析/扫描组件版本矩阵;API 密钥勿入库,敏感输出需做日志脱敏。
- 安全表强调命令执行宜在白名单/沙箱思路下使用,勿把不可信输入拼进 shell。
使用场景
- 合并前需要对 `Python`/`JS` 等多文件做批量评审并输出统一质量指标报告
- 发布前要基于 lockfile 或依赖清单跑漏洞检测并整理升级建议清单
- 重构前先对热点模块做复杂度可视化并记录重构建议到结构化上下文
- 流水线里在提交触发时调用技能,把静态分析与测试结果写回部署状态类输出
适合人员
- 维护多语言单体仓库、要在合入前统一出评审报告的后端 Tech Lead
- 负责依赖合规与安全周报、需要可复用漏洞与升级建议输出的应用安全工程师
- 把设计决策与变更日志写在 wiki 里、希望同步生成结构化 context 文件的架构师
- 在 Jenkins/GitLab CI 中编排构建步骤、要把代码分析嵌进流水线的 DevOps 工程师