全栈工程纪律adithya-hmt/fullstack-expert

@deepseek-ai/fullstack-expert

CI
Release
License: MIT

让编码代理展示其工作过程。 Fullstack Expert 是面向 DeepSeek Harness 编码代理的 Cordis 原生工作流与安全层。它使仓库检查、垂直切片规划、敏感操作边界以及最新的验证证据变得明确——同时不引入第二套代理框架、shell、文件系统、浏览器、数据库或模型提供方。

这不是一个更聪明的模型。它是在你已使用的 Harness 能力之上，构建的一个更有纪律的工程循环。

- 安装： QUICKSTART.md
- 查看实际效果： docs/demo.md
- 最新版本： GitHub Releases
- 问题与缺陷： GitHub Issues

V0.1 提供的内容

- 一个有范围限定的方法论提示：理解 → 检查 → 设计 → 规划 → 实现 → 测试 → 审查 → 验证。
- 两个面向模型的深层操作：
- fullstack_plan：有边界的仓库检查加上垂直切片计划。
- fullstack_check：只读项目检查以及明确的证据记录。
- 一个确定性的 FullstackExpertRuntime 状态接缝，用于阶段、任务、证据和紧凑事件事实。
- 通过原生 ctx.skills 注册的内嵌窄范围技能。
- 基于需求、复用、原生平台、依赖和安全控制的复杂度治理决策。
- 权限分类以及一个感知审批的执行前门禁，将敏感操作委托给原生 Harness 审批，并在审批不可用时故障关闭。
- 可选的、只读的 Supabase 项目证据检测。
- 使用原生 session/event 和 tools/result 进行会话/工具结果观察；Harness 会话日志仍是持久的事实来源。
- 提供方中立的操作：该插件从不选择或硬编码 LLM 适配器。GPT-5.6 Max 在 Harness 模型路由中配置。

诚实的范围

V0.1 不提供浏览器驱动、shell 执行器、文件系统后端、开发服务器注册表、Supabase SDK、数据库客户端、部署适配器或模型提供方。当所选的 Harness 组合暴露这些能力时，它会复用它们。因此，在稳定的浏览器工具被组合进来之前，浏览器验证只是指导加证据记录。Supabase 操作仅为检测/建议；迁移、链接、登录、推送、重置、拉取、函数部署和外部写入仍属于明确的敏感操作。

作为配置文件包安装

最快路径
安装 DeepSeek Harness CLI 后，直接从 GitHub 添加带标签的发布版本：

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 替换为你的 profile 名称。第一条命令安装该包并激活其声明的补丁层。第二条命令在启动前确认组合后的行。一旦启用 npm 发布，更短的 @deepseek-ai/fullstack-expert 包规格也将可用。有关完整设置、故障排除以及本地检出路径，请参阅 QUICKSTART.md。

手动 profile 覆盖

将此包构建/发布到某个 profile 的依赖闭包中，然后在 profile 的基础 bundle 之后添加提供的 cordis.patch.yml 覆盖：

- insert:
- id: fullstack-expert
name: '@deepseek-ai/fullstack-expert'
config:
registerSkills: true

该覆盖有意保持精简。profile 必须已经组合了原生 Harness 行，例如 dsh-fs、dsh-fs-local、dsh-shell、一个 shell 执行器、dsh-tools、dsh-skill 以及相关的模型适配器。

对于用户拥有的预设，请复制随附的 standard 预设，而不是编辑安装内容，然后将该行添加到复制后的 agent.cordis.yml 中。为复制后的预设提供一个 preset.yml，其中包含人类可读的 name 和 description，否则在选择器中它可能仅以其目录 id 显示。贡献 Service 的插件行必须放置在宿主组合中，或者当其消费者为会话所有时，放置在条目本地隔离领域中。

GPT-5.6 Max / OpenAI 兼容 CLI 代理

将提供方配置保留在此包之外。使用 Harness 提供方/模型设置界面配置现有的 OpenAI 兼容 CLI 代理，选择：

provider:
model: GPT-5.6 Max

确切的提供方 id、端点、凭据绑定和 CLI 命令因部署而异。不要将凭据放入此仓库或提示上下文中。该插件仅消费提供方中立的 agent/session 接口。

用法

1. 从包含该插件以及原生 Harness 文件系统/工具/技能行的组合开始。
2. 请求一项功能、缺陷修复、审查、重构或应用构建。
3. 对于重要工作，agent 应调用 fullstack_plan，检查实际文件，陈述假设/未知项，并使用原生工具实现一个垂直切片。
4. 使用 fullstack_check 进行有界结构/命令/Supabase 检查，并记录非验证性的审查事实。验证证据必须来自原生 Harness 检查；V0.1 拒绝自我声明的验证记录。
5. 只有在原生 verification 证据记录通过且相关失败不存在后，才能判定完成。
原生 shell 工具会报告其 [exit code: N] 标记；请调查每一个非零结果。对于浏览器相关工作，请使用组合式浏览器能力，并记录实际的 console/network/UI 证据，而不是将构建视为证明。

开发

要求：Node.js >=22，以及通过 npm ci 安装的 Harness peer composition。

npm ci
npm run verify
npm run test:consumer
npm run test:profile

test:consumer 会将打包好的 tarball 安装到一个临时 consumer 中，并针对真实的 peer 包挂载 fullstack_plan 和 fullstack_check。test:profile 会将该 tarball 安装到一个一次性的 Harness profile 中，并检查组合后的 patch 层；它需要 dsh 和 pnpm（或使用文档中所述的 pnpm 回退方案）。

该仓库有意保持轻依赖。源码为纯 ESM JavaScript，且该包发布源码入口点以及 Cordis patch，与插件的纯运行时契约一致。

文档

- docs/architecture.md
- docs/methodology.md
- docs/skills.md
- docs/workflows.md
- docs/complexity-policy.md
- docs/verification.md
- docs/permissions.md
- docs/supabase.md
- docs/model-provider.md
- docs/extending.md
- docs/demo.md
- docs/releasing.md
- docs/reference-methodologies.md
- docs/harness-seams.md

社区与推广

如果 Fullstack Expert 对某个真实项目有所帮助，请在 issue 或 discussion 中分享任务和验证证据（不含机密信息）。添加 dsh-plugin 主题，以帮助 DeepSeek Harness 用户发现它。一个简短的演示比一句声明更有用：请从 docs/demo.md 开始。

许可证与来源

该插件实现采用 MIT 许可证。docs/reference-methodologies.md 中的方法论报告记录了为 Superpowers、mattpocock/skills 和 Ponytail 所参考的固定 MIT 来源，并附有引用，且清晰区分了灵感来源与复制代码。未捆绑任何参考实现文本。