DeepSeek Harness 编码智能体在处理复杂任务时,往往缺乏显式的工程流程和可追溯的证据。fullstack-expert 插件为此提供了一套 Cordis 原生的工作流和安全层,旨在让智能体的操作过程、计划与验证变得透明且可控。
插件定位¶
这是一个面向 DeepSeek Harness 代理的 Cordis 原生、证据驱动的全栈工程规范。它不引入新的代理框架、Shell、文件系统、浏览器或数据库客户端,而是通过注册原生能力,为现有 Harness 流程增加一层工程纪律。
核心功能¶
- Cordis 原生工作流与安全层:作为 DeepSeek Harness 编码代理的原生工作流和安全层。
- 仓库检查与规划:支持对仓库的检查,以及垂直切片规划。
- 敏感操作边界:明确界定敏感操作的范围。
- 证据记录:记录新鲜的验证证据,并确保验证证据必须来自 Harness 的原生检查,而非自证。
- 确定性运行时 Seam:提供
FullstackExpertRuntime状态 seam,用于管理阶段、任务、证据和紧凑事件事实。 - 嵌入式技能:通过原生
ctx.skills注册嵌入式窄技能。 - 权限与审批:包含权限分类,并在执行前提供审批感知的门禁,敏感操作会委托给 Harness 的原生审批,若不可用则关闭失败。
- Supabase 检测:可选的、只读的 Supabase 项目证据检测。
- 提供程序中立:操作时不选择或硬编码 LLM 适配器。
安装与启用¶
使用 DeepSeek Harness CLI 安装此插件。安装命令会激活其声明的补丁层。
dsh plugin --profile web add git+https://github.com/adithya-hmt/fullstack-expert.git#v0.1.1
dsh --profile web --dump-config
dsh --profile web
请将 web 替换为您配置文件的实际名称。
典型用法¶
- 请求任务:向代理请求功能、Bug 修复、代码审查、重构或应用构建。
- 垂直切片规划:对于实质性工作,代理应调用
fullstack_plan。此操作会进行仓库检查、陈述假设/未知数,并使用原生工具实现垂直切片。 - 结构化检查:使用
fullstack_check进行结构、命令或 Supabase 检查,并记录非验证审查事实。 - 验证完成:只有当来自 Harness 的原生
verification证据记录通过且相关失败不存在时,才能完成工作。
注意事项与范围¶
- 不引入额外组件:插件不会引入第二个代理框架、Shell 执行器、文件系统后端、浏览器驱动、数据库客户端或模型提供程序。它重用 Harness 组合中暴露的现有能力。
- 浏览器验证:浏览器验证目前是指导加上证据记录,直到稳定的浏览器工具被组合完成。
- Supabase 操作:Supabase 操作仅限检测和建议;迁移、链接、登录、推送、重置、拉取、函数部署和外部写入仍为显式敏感操作。
- 配置管理:提供程序配置应保持在此包之外。使用 Harness 提供程序/模型设置表面配置现有的 OpenAI 兼容 CLI 代理(例如
provider: <your proxy adapter>,model: GPT-5.6 Max)。 - 许可证:插件实现遵循 MIT 许可证。
总结¶
fullstack-expert 旨在让编码智能体「展示其工作」。它通过原生 Cordis 能力和显式的工作流,将仓库检查、垂直切片规划、敏感操作边界和验证证据标准化,适合需要在 DSH 中实现严谨工程流程的开发者。